seam-commits May 2009

seam-commits@lists.jboss.org

1 participants
316 discussions

Seam SVN: r10947 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-23 08:44:18 -0400 (Sat, 23 May 2009) New Revision: 10947 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po 2009-05-23 11:54:56 UTC (rev 10946) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po 2009-05-23 12:44:18 UTC (rev 10947) @@ -6,7 +6,7 @@ "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" "POT-Creation-Date: 2009-05-05 12:31+0000\n" -"PO-Revision-Date: 2009-05-23 12:48+0100\n" +"PO-Revision-Date: 2009-05-23 14:43+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -854,13 +854,13 @@ #: Configuration.xml:434 #, no-c-format msgid "For application servers that stubbornly adhere to the EJB specification, EJB references must always be defined explicitly. But unlike with the web context, where a single resource reference covers all uses of the EJB from the web environment, you cannot declare EJB references globally in the EJB container. Instead, you have to specify the JNDI resources for a given EJB component one-by-one." -msgstr "" +msgstr "Per gli application server che aderiscono testardamente alla specifica EJB, i riferimenti EJB devono sempre essere definititi esplicitamente. Ma diversamente dal contesto web, dove un singolo riferimento di una risorsa copre tutti gli usi di EJB, non si possono dichiarare i riferimenti EJB in modo globale nel container EJB. Invece si devono specificare le risorse JNDI per un dato componente EJB una per una." #. Tag: para #: Configuration.xml:439 #, no-c-format msgid "Let's assume that we have an EJB named RegisterAction (the name is resolved using the three steps mentioned previously). That EJB has the following Seam injection:" -msgstr "" +msgstr "Si assuma di avere un EJB chiamato RegisterAction (nome che viene risolto usando i tre passi menzionati prima). Questo EJB ha la seguente injection Seam:" #. Tag: programlisting #: Configuration.xml:442 @@ -922,13 +922,13 @@ #: Configuration.xml:448 #, no-c-format msgid "Notice that the contents of the <literal><ejb-local-ref></literal> are identical to what we defined in web.xml. What we are doing is bringing the reference into the EJB context where it can be used by the RegisterAction bean. You will need to add one of these references for any injection of a Seam EJB compoenent into another Seam EJB component using <literal>@In</literal>. (You can see an example of this setup in the jee5/booking example)." -msgstr "" +msgstr "Si noti che i contenuti di <literal><ejb-local-ref></literal> sono identici a ciò che viene definito in web.xml. Ciò che viene fatto è portare il riferimento nel contesto EJB dove può essere usato dal bean RegisterAction. Occorre aggiungere uno di questi riferimenti per qualsiasi injection di componente EJB Seam in un altro componente EJB Seam con <literal>@In</literal>. (Vedere l'esempio di setup di jee5/booking)." #. Tag: para #: Configuration.xml:454 #, no-c-format msgid "But what about <literal>@EJB</literal>? It's true that you can inject one EJB into another using <literal>@EJB</literal>. However, by doing so, you are injecting the actual EJB reference rather than the Seam EJB component instance. In this case, some Seam features will work, while others won't. That's because Seam's interceptor is invoked on any method call to an EJB component. But that only invokes Seam's server-side interceptor chain. What you lose is Seam's state management and Seam's client-side interceptor chain. Client-side interceptors handle concerns such as security and concurrency. Also, when injecting a SFSB, there is no guarantee that you will get the SFSB bound to the active session or conversation, whatever the case may be. Thus, you definitely want to inject the Seam EJB component using <literal>@In</literal>." -msgstr "" +msgstr "E riguardo <literal>@EJB</literal>? E' vero che si può iniettare un EJB in un altro usando <literal>@EJB</literal>. Comunque, facendo così, si sta iniettando il riferimento EJB piuttosto che l'istanza del componente EJB Seam. In questo caso, alcune funzionalità di Seam funzioneranno, mentre altre no. Questo perchè l'interceptor di Seam viene invocato ad ogni chiamata di metodo in un componente EJB. Ma questo invoca solo la catena dell'interceptor Seam lato server. Ciò che viene persa è la gestione dello stato di Seam e la catena dell'interceptor lato client. Gli interceptor lato client gestiscono i concern quali sicurezza e concorrenza. Inoltre, quando si inietta un SFSB, non c'è garanzia che il SFSB venga associato alla conversazione o sessione attiva, qualunque sia il caso. Quindi si inietterà il componente EJB Seam usando <literal>@In</literal>." #. Tag: para #: Configuration.xml:464 @@ -970,13 +970,13 @@ #: Configuration.xml:491 #, no-c-format msgid "In a web archive (WAR) file, you must place a <literal>seam.properties</literal> file in the <literal>WEB-INF/classes</literal> directory if you have any Seam components included here." -msgstr "" +msgstr "Nel file WAR occorre mettere il file <literal>seam.properties</literal> nella directory <literal>WEB-INF/classes</literal> qualora si abbiano componenti Seam da includere." #. Tag: para #: Configuration.xml:494 #, no-c-format msgid "That's why all the Seam examples have an empty <literal>seam.properties</literal> file. You can't just delete this file and expect everything to still work!" -msgstr "" +msgstr "E' questo il motivo per cui tutti gli esempi Seam hanno un file <literal>seam.properties</literal> vuoto. Non si può cancellare questo file ed attendersi che tutto funzioni!" #. Tag: para #: Configuration.xml:497 @@ -994,7 +994,7 @@ #: Configuration.xml:510 #, no-c-format msgid "Seam comes packaged and configured with Hibernate as the default JPA provider. If you require using a different JPA provider you must tell <literal>seam</literal> about it." -msgstr "" +msgstr "Seam viene assemblato e configurato con Hibernate in qualità di provider JPA. Se si vuole usare un diverso provider JPA occorre dirlo a <literal>seam</literal>." #. Tag: title #: Configuration.xml:516 @@ -1006,13 +1006,13 @@ #: Configuration.xml:517 #, no-c-format msgid "Configuration of the JPA provider will be easier in the future and will not require configuration changes, unless you are adding a custom persistence provider implementation." -msgstr "" +msgstr "La configurazione del provider JPA sarà più semplice in futuro e non richiederà cambiamenti nella configurazione, amenoché non si aggiunga un'implementazione personalizzata del provider di persistenza." #. Tag: para #: Configuration.xml:524 #, no-c-format msgid "Telling seam about a different JPA provider can be be done in one of two ways:" -msgstr "" +msgstr "Comunicare a Seam di usare un altro provider JPA può essere realizzato in uno dei due modi:" #. Tag: para #: Configuration.xml:525 @@ -1164,7 +1164,7 @@ #: Configuration.xml:568 #, no-c-format msgid "You should declare <literal>jboss-seam.jar</literal> as an ejb module in <literal>META-INF/application.xml</literal>; <literal>jboss-el.jar</literal> should be placed in the EAR's lib directory (putting it in the EAR classpath." -msgstr "" +msgstr "Si dovrebbe dichiarare <literal>jboss-seam.jar</literal> come modulo ejb in <literal>META-INF/application.xml</literal>; <literal>jboss-el.jar</literal> dovrebbe essere collocato nella directory lib dell'EAR (mettendolo nel classpath dell'EAR)." #. Tag: para #: Configuration.xml:573 @@ -1194,7 +1194,7 @@ #: Configuration.xml:586 #, no-c-format msgid "Seam ships with several example applications that are deployable in any Java EE container that supports EJB 3.0." -msgstr "" +msgstr "Seam porta con sé parecchi esempi di applicazioni che sono deployate in un container Java EE che supporta EJB 3.0." #. Tag: para #: Configuration.xml:589 @@ -1236,7 +1236,7 @@ #: Configuration.xml:628 #, no-c-format msgid "Seam will bootstrap a Hibernate <literal>SessionFactory</literal> from your <literal>hibernate.cfg.xml</literal> file if you install a built-in component:" -msgstr "" +msgstr "Seam avvierà un <literal>SessionFactory</literal> di Hibernate dal file <literal>hibernate.cfg.xml</literal> se si installa un componente predefinito:" #. Tag: programlisting #: Configuration.xml:631 @@ -1462,19 +1462,19 @@ #: Configuration.xml:741 #, no-c-format msgid "Remove the <literal>annotations-api.jar</literal> file from the Tomcat <literal>lib</literal> directory." -msgstr "" +msgstr "Rimuovere il file <literal>annotations-api.jar</literal> dalla directory Tomcat <literal>lib</literal>." #. Tag: para #: Configuration.xml:747 #, no-c-format msgid "Next, two configuration files need to be updated to add Embedded JBoss-specific functionality." -msgstr "" +msgstr "Poi devono essere aggiornati due file di configurazione per poter aggiungere funzionalità specifiche di JBoss Embedded." #. Tag: para #: Configuration.xml:753 #, no-c-format msgid "Add the Embedded JBoss listener <literal>EmbeddedJBossBootstrapListener</literal> to <literal>conf/server.xml</literal>. It must appear after all other listeners in the file:" -msgstr "" +msgstr "Aggiungere il listener Embedded JBoss <literal>EmbeddedJBossBootstrapListener</literal> a <literal>conf/server.xml</literal>. Deve apparire dopo tutti gli altri listener nel file:" #. Tag: programlisting #: Configuration.xml:756 @@ -1574,7 +1574,7 @@ #: Configuration.xml:781 #, no-c-format msgid "On Unix, use this syntax instead:" -msgstr "" +msgstr "In Unix, usare invece questa sintassi:" #. Tag: programlisting #: Configuration.xml:783 @@ -1586,7 +1586,7 @@ #: Configuration.xml:788 #, no-c-format msgid "For more configuration options, please see the Embedded JBoss Tomcat integration <ulink url=\"http://wiki.jboss.org/wiki/Wiki.jsp?page=EmbeddedAndTomcat\">wiki entry</ulink>." -msgstr "" +msgstr "Per ulteriorio opzioni di configurazione, si prega di vedere l'integrazione con Embedded JBoss Tomcat <ulink url=\"http://wiki.jboss.org/wiki/Wiki.jsp?page=EmbeddedAndTomcat\">wiki entry</ulink>." #. Tag: para #: Configuration.xml:796 @@ -1762,7 +1762,7 @@ #: Configuration.xml:823 #, no-c-format msgid "The most important thing to notice here is that jBPM transaction control is disabled. Seam or EJB3 should control the JTA transactions." -msgstr "" +msgstr "La cosa più importante da notare è che il controllo della transazione jBPM è disabilitato. Seam o EJB3 dovrebbero controllare le transazioni JTA." #. Tag: para #: Configuration.xml:829 @@ -1874,7 +1874,7 @@ #: Configuration.xml:849 #, no-c-format msgid "The default SFSB timeout can be adjusted by modifying the value of <literal>max-bean-life</literal> in the <literal>LRUStatefulContextCachePolicy</literal> cache configuration:" -msgstr "" +msgstr "Il timeout di default di SFSB può essere impostato modificando il valore di <literal>max-bean-life</literal> nella configurazione della cache <literal>LRUStatefulContextCachePolicy</literal>:" #. Tag: programlisting #: Configuration.xml:852 @@ -1942,7 +1942,7 @@ #: Configuration.xml:861 #, no-c-format msgid "To override this value for your own application, simply include this entry in your application's own <literal>web.xml</literal>." -msgstr "" +msgstr "Per sovrascrivere questo valore per la propria applicazione, si includa semplicemente questa riga nel proprio <literal>web.xml</literal>." #. Tag: title #: Configuration.xml:867 @@ -1966,7 +1966,7 @@ #: Configuration.xml:882 #, no-c-format msgid "Seam scans all jars containing <literal>/seam.properties</literal>, <literal>/META-INF/components.xml</literal> or <literal>/META-INF/seam.properties</literal> on startup for resources. For example, all classes annotated with <literal>@Name</literal> are registered with Seam as Seam components." -msgstr "" +msgstr "Seam scansiona all'avvio tutti i jar contenenti <literal>/seam.properties</literal>, <literal>/META-INF/components.xml</literal> o <literal>/META-INF/seam.properties</literal>. Per esempio, tutte le classi annotate con <literal>@Name</literal> vengono registrate da Seam come componenti Seam." #. Tag: para #: Configuration.xml:889

16 years, 11 months

1
0
0 / 0

Seam SVN: r10946 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-23 07:54:56 -0400 (Sat, 23 May 2009) New Revision: 10946 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po 2009-05-23 11:50:59 UTC (rev 10945) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po 2009-05-23 11:54:56 UTC (rev 10946) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2009-05-23 13:44+0100\n" "Last-Translator: Francesco Milesi <milesif(a)gmail.com>\n" "Language-Team: none\n" @@ -22,12 +22,25 @@ #. Tag: para #: Remoting.xml:6 #, no-c-format -msgid "Seam provides a convenient method of remotely accessing components from a web page, using AJAX (Asynchronous Javascript and XML). The framework for this functionality is provided with almost no up-front development effort - your components only require simple annotating to become accessible via AJAX. This chapter describes the steps required to build an AJAX-enabled web page, then goes on to explain the features of the Seam Remoting framework in more detail." -msgstr "Seam fornisce un metodo per accedere in modo remoto i componenti da una pagina web, usando AJAX (Asynchronous Javascript and XML). Il framework per questa funzionalità viene fornito con quasi nessuno sforzo di sviluppo - i componenti richiedono solamente una semplice annotazione per diventare accessibile via AJAX. Questo capitolo descrive i passi richiesti per costruire una pagina web abilitata a AJAX, poi spiega con maggior dettaglio le caratteristiche del framework Seam Remoting." +msgid "" +"Seam provides a convenient method of remotely accessing components from a " +"web page, using AJAX (Asynchronous Javascript and XML). The framework for " +"this functionality is provided with almost no up-front development effort - " +"your components only require simple annotating to become accessible via " +"AJAX. This chapter describes the steps required to build an AJAX-enabled web " +"page, then goes on to explain the features of the Seam Remoting framework in " +"more detail." +msgstr "" +"Seam fornisce un metodo per accedere in modo remoto i componenti da una " +"pagina web, usando AJAX (Asynchronous Javascript and XML). Il framework per " +"questa funzionalità viene fornito con quasi nessuno sforzo di sviluppo - i " +"componenti richiedono solamente una semplice annotazione per diventare " +"accessibile via AJAX. Questo capitolo descrive i passi richiesti per " +"costruire una pagina web abilitata a AJAX, poi spiega con maggior dettaglio " +"le caratteristiche del framework Seam Remoting." #. Tag: title -#: Remoting.xml:13 -#: Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "Configurazione" @@ -35,8 +48,12 @@ #. Tag: para #: Remoting.xml:14 #, no-c-format -msgid "To use remoting, the Seam Resource servlet must first be configured in your <literal>web.xml</literal> file:" -msgstr "Per usare remoting, il resource servlet di Seam deve essere innanzitutto configurato nel file <literal>web.xml</literal>:" +msgid "" +"To use remoting, the Seam Resource servlet must first be configured in your " +"<literal>web.xml</literal> file:" +msgstr "" +"Per usare remoting, il resource servlet di Seam deve essere innanzitutto " +"configurato nel file <literal>web.xml</literal>:" #. Tag: programlisting #: Remoting.xml:16 @@ -65,52 +82,92 @@ #. Tag: para #: Remoting.xml:18 #, no-c-format -msgid "The next step is to import the necessary Javascript into your web page. There are a minimum of two scripts that must be imported. The first one contains all the client-side framework code that enables remoting functionality:" -msgstr "Il passo successivi è importare il Javascript necessario nella propria pagina web. Ci sono un minimo di due script da importare. Il primo contiene tutto il codice del framework lato client che abilita le funzionalità di remoting:" +msgid "" +"The next step is to import the necessary Javascript into your web page. " +"There are a minimum of two scripts that must be imported. The first one " +"contains all the client-side framework code that enables remoting " +"functionality:" +msgstr "" +"Il passo successivi è importare il Javascript necessario nella propria " +"pagina web. Ci sono un minimo di due script da importare. Il primo contiene " +"tutto il codice del framework lato client che abilita le funzionalità di " +"remoting:" #. Tag: programlisting #: Remoting.xml:22 #, no-c-format -msgid "<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/resource/remote.js\"></script>]]>" -msgstr "<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/resource/remote.js\"></script>]]>" +msgid "" +"<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/" +"resource/remote.js\"></script>]]>" +msgstr "" +"<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/" +"resource/remote.js\"></script>]]>" #. Tag: para #: Remoting.xml:24 #, no-c-format -msgid "The second script contains the stubs and type definitions for the components you wish to call. It is generated dynamically based on the local interface of your components, and includes type definitions for all of the classes that can be used to call the remotable methods of the interface. The name of the script reflects the name of your component. For example, if you have a stateless session bean annotated with <literal>@Name(\"customerAction\")</literal>, then your script tag should look like this:" -msgstr "Il secondo script contiene gli stub e le definizioni tipo per i componenti da chiamare. Viene generato dinamicamente basandosi sull'interfaccia locale dei propri componenti, ed include le definizioni tipo per tutte le classi che possono essere usate per chiamare i metodi remoti dell'interfaccia. Il nome dello script riflette il nome del componente. Per esempio se si ha un bean di sessione stateless annotato con <literal>@Name(\"customerAction\")</literal>, allora il tag dello script dovrebbe essere simile a:" +msgid "" +"The second script contains the stubs and type definitions for the components " +"you wish to call. It is generated dynamically based on the local interface " +"of your components, and includes type definitions for all of the classes " +"that can be used to call the remotable methods of the interface. The name of " +"the script reflects the name of your component. For example, if you have a " +"stateless session bean annotated with <literal>@Name(\"customerAction\")</" +"literal>, then your script tag should look like this:" +msgstr "" +"Il secondo script contiene gli stub e le definizioni tipo per i componenti " +"da chiamare. Viene generato dinamicamente basandosi sull'interfaccia locale " +"dei propri componenti, ed include le definizioni tipo per tutte le classi " +"che possono essere usate per chiamare i metodi remoti dell'interfaccia. Il " +"nome dello script riflette il nome del componente. Per esempio se si ha un " +"bean di sessione stateless annotato con <literal>@Name(\"customerAction\")</" +"literal>, allora il tag dello script dovrebbe essere simile a:" #. Tag: programlisting #: Remoting.xml:30 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" #. Tag: para #: Remoting.xml:32 #, no-c-format -msgid "If you wish to access more than one component from the same page, then include them all as parameters of your script tag:" -msgstr "Se si vuole accedere a più di un componente dalla stessa pagina, allora li si includa tutti come parametri nel tag script:" +msgid "" +"If you wish to access more than one component from the same page, then " +"include them all as parameters of your script tag:" +msgstr "" +"Se si vuole accedere a più di un componente dalla stessa pagina, allora li " +"si includa tutti come parametri nel tag script:" #. Tag: programlisting #: Remoting.xml:35 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction&accountAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?" +"customerAction&accountAction\"></script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction&accountAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?" +"customerAction&accountAction\"></script>]]>" #. Tag: para #: Remoting.xml:38 #, no-c-format -msgid "Alternatively, you may use the <literal>s:remote</literal> tag to import the required Javascript. Separate each component or class name you wish to import with a comma:" -msgstr "In alternativa si può usare il tag <literal>s:remote</literal> per importare il Javascript richiesto. Si separi ciascun componente o nome di classe che si vuole importare con una virgola:" +msgid "" +"Alternatively, you may use the <literal>s:remote</literal> tag to import the " +"required Javascript. Separate each component or class name you wish to " +"import with a comma:" +msgstr "" +"In alternativa si può usare il tag <literal>s:remote</literal> per importare " +"il Javascript richiesto. Si separi ciascun componente o nome di classe che " +"si vuole importare con una virgola:" #. Tag: programlisting #: Remoting.xml:43 @@ -133,8 +190,24 @@ #. Tag: para #: Remoting.xml:50 #, no-c-format -msgid "Client-side interaction with your components is all performed via the <literal>Seam</literal> Javascript object. This object is defined in <literal>remote.js</literal>, and you'll be using it to make asynchronous calls against your component. It is split into two areas of functionality; <literal>Seam.Component</literal> contains methods for working with components and <literal>Seam.Remoting</literal> contains methods for executing remote requests. The easiest way to become familiar with this object is to start with a simple example." -msgstr "L'interazione lato client con i componenti viene eseguita tutta tramite l'oggetto Javascript <literal>Seam</literal>. Quest'oggetti è definito in <literal>remote.js</literal>, e lo si userà per fare chiamate asincrone verso il componente. E' suddiviso in due aree di funzionalità; <literal>Seam.Component</literal> contiene metodi per lavorare con i componenti e <literal>Seam.Remoting</literal> contiene metodi per eseguire le richieste remote. La via più facile per diventare familiare con quest'oggetto è cominciare con un semplice esempio." +msgid "" +"Client-side interaction with your components is all performed via the " +"<literal>Seam</literal> Javascript object. This object is defined in " +"<literal>remote.js</literal>, and you'll be using it to make asynchronous " +"calls against your component. It is split into two areas of functionality; " +"<literal>Seam.Component</literal> contains methods for working with " +"components and <literal>Seam.Remoting</literal> contains methods for " +"executing remote requests. The easiest way to become familiar with this " +"object is to start with a simple example." +msgstr "" +"L'interazione lato client con i componenti viene eseguita tutta tramite " +"l'oggetto Javascript <literal>Seam</literal>. Quest'oggetti è definito in " +"<literal>remote.js</literal>, e lo si userà per fare chiamate asincrone " +"verso il componente. E' suddiviso in due aree di funzionalità; <literal>Seam." +"Component</literal> contiene metodi per lavorare con i componenti e " +"<literal>Seam.Remoting</literal> contiene metodi per eseguire le richieste " +"remote. La via più facile per diventare familiare con quest'oggetto è " +"cominciare con un semplice esempio." #. Tag: title #: Remoting.xml:57 @@ -145,8 +218,13 @@ #. Tag: para #: Remoting.xml:59 #, no-c-format -msgid "Let's step through a simple example to see how the <literal>Seam</literal> object works. First of all, let's create a new Seam component called <literal>helloAction</literal>." -msgstr "Si cominci con un semplice esempio per vedere come funziona l'oggetto <literal>Seam</literal>" +msgid "" +"Let's step through a simple example to see how the <literal>Seam</literal> " +"object works. First of all, let's create a new Seam component called " +"<literal>helloAction</literal>." +msgstr "" +"Si cominci con un semplice esempio per vedere come funziona l'oggetto " +"<literal>Seam</literal>" #. Tag: programlisting #: Remoting.xml:62 @@ -171,8 +249,14 @@ #. Tag: para #: Remoting.xml:64 #, no-c-format -msgid "You also need to create a local interface for our new component - take special note of the <literal>@WebRemote</literal> annotation, as it's required to make our method accessible via remoting:" -msgstr "E' anche necessario creare un'interfaccia locale per il nuovo componente - tenete a mente in particolare l'annotazione <literal>@WebRemote</literal>, poiché è necessaria a rendere un metodo accessibile via remoting:" +msgid "" +"You also need to create a local interface for our new component - take " +"special note of the <literal>@WebRemote</literal> annotation, as it's " +"required to make our method accessible via remoting:" +msgstr "" +"E' anche necessario creare un'interfaccia locale per il nuovo componente - " +"tenete a mente in particolare l'annotazione <literal>@WebRemote</literal>, " +"poiché è necessaria a rendere un metodo accessibile via remoting:" #. Tag: programlisting #: Remoting.xml:67 @@ -193,35 +277,68 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format -msgid "That's all the server-side code we need to write. Now for our web page - create a new page and import the <literal>helloAction</literal> component:" -msgstr "Questo è tutto il codice lato server che bisogna scrivere. Ora, per quantro riguarda la pagina web - bisogna creare una nuova pagina e importare il componente <literal>helloAction</literal>:" +msgid "That's all the server-side code we need to write." +msgstr "" -#. Tag: programlisting +#. Tag: para #: Remoting.xml:72 #, no-c-format +msgid "" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." +msgstr "" + +#. Tag: para +#: Remoting.xml:78 +#, fuzzy, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" +"Questo è tutto il codice lato server che bisogna scrivere. Ora, per quantro " +"riguarda la pagina web - bisogna creare una nuova pagina e importare il " +"componente <literal>helloAction</literal>:" + +#. Tag: programlisting +#: Remoting.xml:81 +#, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"helloAction\"/>]]>" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format -msgid "To make this a fully interactive user experience, let's add a button to our page:" -msgstr "Per rendere l'esperienza dell'utente veramente interattiva, si aggiunga un bottone alla pagina:" +msgid "" +"To make this a fully interactive user experience, let's add a button to our " +"page:" +msgstr "" +"Per rendere l'esperienza dell'utente veramente interattiva, si aggiunga un " +"bottone alla pagina:" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format -msgid "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" -msgstr "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" +msgid "" +"<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" +msgstr "" +"<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format -msgid "We'll also need to add some more script to make our button actually do something when it's clicked:" -msgstr "Bisognerà anche aggiungere uno script per far fare qualcosa al bottone quando viene cliccato:" +msgid "" +"We'll also need to add some more script to make our button actually do " +"something when it's clicked:" +msgstr "" +"Bisognerà anche aggiungere uno script per far fare qualcosa al bottone " +"quando viene cliccato:" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -229,7 +346,8 @@ "\n" " function sayHello() {\n" " var name = prompt(\"What is your name?\");\n" -" Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);\n" +" Seam.Component.getInstance(\"helloAction\").sayHello(name, " +"sayHelloCallback);\n" " }\n" "\n" " function sayHelloCallback(result) {\n" @@ -244,7 +362,8 @@ "\n" " function sayHello() {\n" " var name = prompt(\"What is your name?\");\n" -" Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);\n" +" Seam.Component.getInstance(\"helloAction\").sayHello(name, " +"sayHelloCallback);\n" " }\n" "\n" " function sayHelloCallback(result) {\n" @@ -255,67 +374,142 @@ "</script>]]>" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format -msgid "We're done! Deploy your application and browse to your page. Click the button, and enter a name when prompted. A message box will display the hello message confirming that the call was successful. If you want to save some time, you'll find the full source code for this Hello World example in Seam's <literal>/examples/remoting/helloworld</literal> directory." -msgstr "Abbiamo finito! Installate l'applicazione e andate col browser alla pagina creata. Premete il pulsante e inserite un nome quando richiesto. Una finestra mostrerà il messaggio di saluto che confermerà che la chiamata è avvenuta con successo. Per risparmiare tempo, cercate il codice dell'esempio Hello World nella directory <literal>/examples/remoting/helloworld</literal> di Seam." +msgid "" +"We're done! Deploy your application and browse to your page. Click the " +"button, and enter a name when prompted. A message box will display the hello " +"message confirming that the call was successful. If you want to save some " +"time, you'll find the full source code for this Hello World example in " +"Seam's <literal>/examples/remoting/helloworld</literal> directory." +msgstr "" +"Abbiamo finito! Installate l'applicazione e andate col browser alla pagina " +"creata. Premete il pulsante e inserite un nome quando richiesto. Una " +"finestra mostrerà il messaggio di saluto che confermerà che la chiamata è " +"avvenuta con successo. Per risparmiare tempo, cercate il codice dell'esempio " +"Hello World nella directory <literal>/examples/remoting/helloworld</literal> " +"di Seam." #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format -msgid "So what does the code of our script actually do? Let's break it down into smaller pieces. To start with, you can see from the Javascript code listing that we have implemented two methods - the first method is responsible for prompting the user for their name and then making a remote request. Take a look at the following line:" -msgstr "Quindi, cosa fa realmente il codice del nostro script? Dividiamolo in pezzi più piccoli. Tanto per iniziare, dal listato Javascript si vede che abbiamo implementato due metodi - il primo serve a chiedere all'utente il suo nome e a fare una richiesta remota. Guardate la seguente linea:" +msgid "" +"So what does the code of our script actually do? Let's break it down into " +"smaller pieces. To start with, you can see from the Javascript code listing " +"that we have implemented two methods - the first method is responsible for " +"prompting the user for their name and then making a remote request. Take a " +"look at the following line:" +msgstr "" +"Quindi, cosa fa realmente il codice del nostro script? Dividiamolo in pezzi " +"più piccoli. Tanto per iniziare, dal listato Javascript si vede che abbiamo " +"implementato due metodi - il primo serve a chiedere all'utente il suo nome e " +"a fare una richiesta remota. Guardate la seguente linea:" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format -msgid "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" -msgstr "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" +msgid "" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" +msgstr "" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format -msgid "The first section of this line, <literal>Seam.Component.getInstance(\"helloAction\")</literal> returns a proxy, or \"stub\" for our <literal>helloAction</literal> component. We can invoke the methods of our component against this stub, which is exactly what happens with the remainder of the line: <literal>sayHello(name, sayHelloCallback);</literal>." -msgstr "La prima parte di questa linea, <literal>Seam.Component.getInstance(\"helloAction\")</literal> restituisce un proxy, o \"stub\", del componente <literal>helloAction</literal>. Possiamo chiamare i metodi di questo componente usando tale stub, che è ciò che accade nel resto della linea: <literal>sayHello(name, sayHelloCallback);</literal>." +msgid "" +"The first section of this line, <literal>Seam.Component.getInstance" +"(\"helloAction\")</literal> returns a proxy, or \"stub\" for our " +"<literal>helloAction</literal> component. We can invoke the methods of our " +"component against this stub, which is exactly what happens with the " +"remainder of the line: <literal>sayHello(name, sayHelloCallback);</literal>." +msgstr "" +"La prima parte di questa linea, <literal>Seam.Component.getInstance" +"(\"helloAction\")</literal> restituisce un proxy, o \"stub\", del componente " +"<literal>helloAction</literal>. Possiamo chiamare i metodi di questo " +"componente usando tale stub, che è ciò che accade nel resto della linea: " +"<literal>sayHello(name, sayHelloCallback);</literal>." #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format -msgid "What this line of code in its completeness does, is invoke the <literal>sayHello</literal> method of our component, passing in <literal>name</literal> as a parameter. The second parameter, <literal>sayHelloCallback</literal> isn't a parameter of our component's <literal>sayHello</literal> method, instead it tells the Seam Remoting framework that once it receives the response to our request, it should pass it to the <literal>sayHelloCallback</literal> Javascript method. This callback parameter is entirely optional, so feel free to leave it out if you're calling a method with a <literal>void</literal> return type or if you don't care about the result." -msgstr "Nel suo complesso questa linea di codice invoca il metodo <literal>sayHello</literal> del componente, passandogli <literal>name</literal> come parametro. Il secondo parametro, <literal>sayHelloCallback</literal> non è un parametro del metodo <literal>sayHello</literal> del componente, ma, invece, comunica al Remoting framework di Seam che, una volta ricevuta la risposta alla richiesta, deve passarla al metodo Javascript <literal>sayHelloCallback</literal>. Questo parametro di callback è completamente opzionale, quindi sentitevi liberi di non usarlo se chiamate un metodo che restituisce <literal>void</literal> o se non siete interessati al risultato." +msgid "" +"What this line of code in its completeness does, is invoke the " +"<literal>sayHello</literal> method of our component, passing in " +"<literal>name</literal> as a parameter. The second parameter, " +"<literal>sayHelloCallback</literal> isn't a parameter of our component's " +"<literal>sayHello</literal> method, instead it tells the Seam Remoting " +"framework that once it receives the response to our request, it should pass " +"it to the <literal>sayHelloCallback</literal> Javascript method. This " +"callback parameter is entirely optional, so feel free to leave it out if " +"you're calling a method with a <literal>void</literal> return type or if you " +"don't care about the result." +msgstr "" +"Nel suo complesso questa linea di codice invoca il metodo <literal>sayHello</" +"literal> del componente, passandogli <literal>name</literal> come parametro. " +"Il secondo parametro, <literal>sayHelloCallback</literal> non è un parametro " +"del metodo <literal>sayHello</literal> del componente, ma, invece, comunica " +"al Remoting framework di Seam che, una volta ricevuta la risposta alla " +"richiesta, deve passarla al metodo Javascript <literal>sayHelloCallback</" +"literal>. Questo parametro di callback è completamente opzionale, quindi " +"sentitevi liberi di non usarlo se chiamate un metodo che restituisce " +"<literal>void</literal> o se non siete interessati al risultato." #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format -msgid "The <literal>sayHelloCallback</literal> method, once receiving the response to our remote request then pops up an alert message displaying the result of our method call." -msgstr "Il metodo <literal>sayHelloCallback</literal>, una volta ricevuta la risposta, mostra un messaggio di avviso con il risultato della chiamata." +msgid "" +"The <literal>sayHelloCallback</literal> method, once receiving the response " +"to our remote request then pops up an alert message displaying the result of " +"our method call." +msgstr "" +"Il metodo <literal>sayHelloCallback</literal>, una volta ricevuta la " +"risposta, mostra un messaggio di avviso con il risultato della chiamata." #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "Seam.Component" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format -msgid "The <literal>Seam.Component</literal> Javascript object provides a number of client-side methods for working with your Seam components. The two main methods, <literal>newInstance()</literal> and <literal>getInstance()</literal> are documented in the following sections however their main difference is that <literal>newInstance()</literal> will always create a new instance of a component type, and <literal>getInstance()</literal> will return a singleton instance." -msgstr "L'oggetto Javascript <literal>Seam.Component</literal> fornisce un serie di metodi lato client per lavorare con i componenti Seam dell'applicazione. I due metodi principali, <literal>newInstance()</literal> e <literal>getInstance()</literal> sono documentati nelle sezioni successive, comunque, la loro differenza principale sta nel fatto che <literal>newInstance()</literal> crea sempre una nuova istanza di un tipo di componente, mentre <literal>getInstance()</literal> restituisce un'istanza singleton." +msgid "" +"The <literal>Seam.Component</literal> Javascript object provides a number of " +"client-side methods for working with your Seam components. The two main " +"methods, <literal>newInstance()</literal> and <literal>getInstance()</" +"literal> are documented in the following sections however their main " +"difference is that <literal>newInstance()</literal> will always create a new " +"instance of a component type, and <literal>getInstance()</literal> will " +"return a singleton instance." +msgstr "" +"L'oggetto Javascript <literal>Seam.Component</literal> fornisce un serie di " +"metodi lato client per lavorare con i componenti Seam dell'applicazione. I " +"due metodi principali, <literal>newInstance()</literal> e " +"<literal>getInstance()</literal> sono documentati nelle sezioni successive, " +"comunque, la loro differenza principale sta nel fatto che " +"<literal>newInstance()</literal> crea sempre una nuova istanza di un tipo di " +"componente, mentre <literal>getInstance()</literal> restituisce un'istanza " +"singleton." #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "Seam.Component.newInstance()" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format -msgid "Use this method to create a new instance of an entity or Javabean component. The object returned by this method will have the same getter/setter methods as its server-side counterpart, or alternatively if you wish you can access its fields directly. Take the following Seam entity component for example:" +msgid "" +"Use this method to create a new instance of an entity or Javabean component. " +"The object returned by this method will have the same getter/setter methods " +"as its server-side counterpart, or alternatively if you wish you can access " +"its fields directly. Take the following Seam entity component for example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -385,25 +579,25 @@ "}" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "var customer = Seam.Component.newInstance(\"customer\");" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -415,43 +609,54 @@ "customer.lastName = \"Smith\";" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "Seam.Component.getInstance()" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format -msgid "The <literal>getInstance()</literal> method is used to get a reference to a Seam session bean component stub, which can then be used to remotely execute methods against your component. This method returns a singleton for the specified component, so calling it twice in a row with the same component name will return the same instance of the component." +msgid "" +"The <literal>getInstance()</literal> method is used to get a reference to a " +"Seam session bean component stub, which can then be used to remotely execute " +"methods against your component. This method returns a singleton for the " +"specified component, so calling it twice in a row with the same component " +"name will return the same instance of the component." msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format -msgid "To continue our example from before, if we have created a new <literal>customer</literal> and we now wish to save it, we would pass it to the <literal>saveCustomer()</literal> method of our <literal>customerAction</literal> component:" +msgid "" +"To continue our example from before, if we have created a new " +"<literal>customer</literal> and we now wish to save it, we would pass it to " +"the <literal>saveCustomer()</literal> method of our <literal>customerAction</" +"literal> component:" msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "Seam.Component.getComponentName()" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format -msgid "Passing an object into this method will return its component name if it is a component, or <literal>null</literal> if it is not." +msgid "" +"Passing an object into this method will return its component name if it is a " +"component, or <literal>null</literal> if it is not." msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -465,61 +670,81 @@ " alert(\"Staff member\");" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "Seam.Remoting" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format -msgid "Most of the client side functionality for Seam Remoting is contained within the <literal>Seam.Remoting</literal> object. While you shouldn't need to directly call most of its methods, there are a couple of important ones worth mentioning." +msgid "" +"Most of the client side functionality for Seam Remoting is contained within " +"the <literal>Seam.Remoting</literal> object. While you shouldn't need to " +"directly call most of its methods, there are a couple of important ones " +"worth mentioning." msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "Seam.Remoting.createType()" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format -msgid "If your application contains or uses Javabean classes that aren't Seam components, you may need to create these types on the client side to pass as parameters into your component method. Use the <literal>createType()</literal> method to create an instance of your type. Pass in the fully qualified Java class name as a parameter:" +msgid "" +"If your application contains or uses Javabean classes that aren't Seam " +"components, you may need to create these types on the client side to pass as " +"parameters into your component method. Use the <literal>createType()</" +"literal> method to create an instance of your type. Pass in the fully " +"qualified Java class name as a parameter:" msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "Seam.Remoting.getTypeName()" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format -msgid "This method is the equivalent of <literal>Seam.Component.getComponentName()</literal> but for non-component types. It will return the name of the type for an object instance, or <literal>null</literal> if the type is not known. The name is the fully qualified name of the type's Java class." +msgid "" +"This method is the equivalent of <literal>Seam.Component.getComponentName()</" +"literal> but for non-component types. It will return the name of the type " +"for an object instance, or <literal>null</literal> if the type is not known. " +"The name is the fully qualified name of the type's Java class." msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "Valutazione delle espressioni EL" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format -msgid "Seam Remoting also supports the evaluation of EL expressions, which provides another convenient method for retrieving data from the server. Using the <literal>Seam.Remoting.eval()</literal> function, an EL expression can be remotely evaluated on the server and the resulting value returned to a client-side callback method. This function accepts two parameters, the first being the EL expression to evaluate, and the second being the callback method to invoke with the value of the expression. Here's an example:" +msgid "" +"Seam Remoting also supports the evaluation of EL expressions, which provides " +"another convenient method for retrieving data from the server. Using the " +"<literal>Seam.Remoting.eval()</literal> function, an EL expression can be " +"remotely evaluated on the server and the resulting value returned to a " +"client-side callback method. This function accepts two parameters, the first " +"being the EL expression to evaluate, and the second being the callback " +"method to invoke with the value of the expression. Here's an example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -541,215 +766,313 @@ " ]]>" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format -msgid "In this example, the expression <literal>#{customers}</literal> is evaluated by Seam, and the value of the expression (in this case a list of Customer objects) is returned to the <literal>customersCallback()</literal> method. It is important to remember that the objects returned this way must have their types imported (via <literal>s:remote</literal>) to be able to work with them in Javascript. So to work with a list of <literal>customer</literal> objects, it is required to import the <literal>customer</literal> type:" +msgid "" +"In this example, the expression <literal>#{customers}</literal> is evaluated " +"by Seam, and the value of the expression (in this case a list of Customer " +"objects) is returned to the <literal>customersCallback()</literal> method. " +"It is important to remember that the objects returned this way must have " +"their types imported (via <literal>s:remote</literal>) to be able to work " +"with them in Javascript. So to work with a list of <literal>customer</" +"literal> objects, it is required to import the <literal>customer</literal> " +"type:" msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customer\"/>]]>" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "Interfacce client" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format -msgid "In the configuration section above, the interface, or \"stub\" for our component is imported into our page either via <literal>seam/resource/remoting/interface.js</literal>: or using the <literal>s:remote</literal> tag:" +msgid "" +"In the configuration section above, the interface, or \"stub\" for our " +"component is imported into our page either via <literal>seam/resource/" +"remoting/interface.js</literal>: or using the <literal>s:remote</literal> " +"tag:" msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customerAction\"/>]]>" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format -msgid "By including this script in our page, the interface definitions for our component, plus any other components or types that are required to execute the methods of our component are generated and made available for the remoting framework to use." +msgid "" +"By including this script in our page, the interface definitions for our " +"component, plus any other components or types that are required to execute " +"the methods of our component are generated and made available for the " +"remoting framework to use." msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format -msgid "There are two types of client stub that can be generated, \"executable\" stubs and \"type\" stubs. Executable stubs are behavioural, and are used to execute methods against your session bean components, while type stubs contain state and represent the types that can be passed in as parameters or returned as a result." +msgid "" +"There are two types of client stub that can be generated, \"executable\" " +"stubs and \"type\" stubs. Executable stubs are behavioural, and are used to " +"execute methods against your session bean components, while type stubs " +"contain state and represent the types that can be passed in as parameters or " +"returned as a result." msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format -msgid "The type of client stub that is generated depends on the type of your Seam component. If the component is a session bean, then an executable stub will be generated, otherwise if it's an entity or JavaBean, then a type stub will be generated. There is one exception to this rule; if your component is a JavaBean (ie it is not a session bean nor an entity bean) and any of its methods are annotated with @WebRemote, then an executable stub will be generated for it instead of a type stub. This allows you to use remoting to call methods of your JavaBean components in a non-EJB environment where you don't have access to session beans." +msgid "" +"The type of client stub that is generated depends on the type of your Seam " +"component. If the component is a session bean, then an executable stub will " +"be generated, otherwise if it's an entity or JavaBean, then a type stub will " +"be generated. There is one exception to this rule; if your component is a " +"JavaBean (ie it is not a session bean nor an entity bean) and any of its " +"methods are annotated with @WebRemote, then an executable stub will be " +"generated for it instead of a type stub. This allows you to use remoting to " +"call methods of your JavaBean components in a non-EJB environment where you " +"don't have access to session beans." msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "Il contesto" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format -msgid "The Seam Remoting Context contains additional information which is sent and received as part of a remoting request/response cycle. At this stage it only contains the conversation ID but may be expanded in the future." +msgid "" +"The Seam Remoting Context contains additional information which is sent and " +"received as part of a remoting request/response cycle. At this stage it only " +"contains the conversation ID but may be expanded in the future." msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "Impostazione e lettura dell'ID di conversazione" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format -msgid "If you intend on using remote calls within the scope of a conversation then you need to be able to read or set the conversation ID in the Seam Remoting Context. To read the conversation ID after making a remote request call <literal>Seam.Remoting.getContext().getConversationId()</literal>. To set the conversation ID before making a request, call <literal>Seam.Remoting.getContext().setConversationId()</literal>." +msgid "" +"If you intend on using remote calls within the scope of a conversation then " +"you need to be able to read or set the conversation ID in the Seam Remoting " +"Context. To read the conversation ID after making a remote request call " +"<literal>Seam.Remoting.getContext().getConversationId()</literal>. To set " +"the conversation ID before making a request, call <literal>Seam.Remoting." +"getContext().setConversationId()</literal>." msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format -msgid "If the conversation ID hasn't been explicitly set with <literal>Seam.Remoting.getContext().setConversationId()</literal>, then it will be automatically assigned the first valid conversation ID that is returned by any remoting call. If you are working with multiple conversations within your page, then you may need to explicitly set the conversation ID before each call. If you are working with just a single conversation, then you don't need to do anything special." +msgid "" +"If the conversation ID hasn't been explicitly set with <literal>Seam." +"Remoting.getContext().setConversationId()</literal>, then it will be " +"automatically assigned the first valid conversation ID that is returned by " +"any remoting call. If you are working with multiple conversations within " +"your page, then you may need to explicitly set the conversation ID before " +"each call. If you are working with just a single conversation, then you " +"don't need to do anything special." msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format -msgid "In some circumstances it may be required to make a remote call within the scope of the current view's conversation. To do this, you must explicitly set the conversation ID to that of the view before making the remote call. This small snippet of JavaScript will set the conversation ID that is used for remoting calls to the current view's conversation ID:" +msgid "" +"In some circumstances it may be required to make a remote call within the " +"scope of the current view's conversation. To do this, you must explicitly " +"set the conversation ID to that of the view before making the remote call. " +"This small snippet of JavaScript will set the conversation ID that is used " +"for remoting calls to the current view's conversation ID:" msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format -msgid "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation.id} );]]>" -msgstr "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation.id} );]]>" +msgid "" +"<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." +"id} );]]>" +msgstr "" +"<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." +"id} );]]>" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "Richieste batch" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format -msgid "Seam Remoting allows multiple component calls to be executed within a single request. It is recommended that this feature is used wherever it is appropriate to reduce network traffic." +msgid "" +"Seam Remoting allows multiple component calls to be executed within a single " +"request. It is recommended that this feature is used wherever it is " +"appropriate to reduce network traffic." msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format -msgid "The method <literal>Seam.Remoting.startBatch()</literal> will start a new batch, and any component calls executed after starting a batch are queued, rather than being sent immediately. When all the desired component calls have been added to the batch, the <literal>Seam.Remoting.executeBatch()</literal> method will send a single request containing all of the queued calls to the server, where they will be executed in order. After the calls have been executed, a single response containining all return values will be returned to the client and the callback functions (if provided) triggered in the same order as execution." +msgid "" +"The method <literal>Seam.Remoting.startBatch()</literal> will start a new " +"batch, and any component calls executed after starting a batch are queued, " +"rather than being sent immediately. When all the desired component calls " +"have been added to the batch, the <literal>Seam.Remoting.executeBatch()</" +"literal> method will send a single request containing all of the queued " +"calls to the server, where they will be executed in order. After the calls " +"have been executed, a single response containining all return values will be " +"returned to the client and the callback functions (if provided) triggered in " +"the same order as execution." msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format -msgid "If you start a new batch via the <literal>startBatch()</literal> method but then decide you don't want to send it, the <literal>Seam.Remoting.cancelBatch()</literal> method will discard any calls that were queued and exit the batch mode." +msgid "" +"If you start a new batch via the <literal>startBatch()</literal> method but " +"then decide you don't want to send it, the <literal>Seam.Remoting.cancelBatch" +"()</literal> method will discard any calls that were queued and exit the " +"batch mode." msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format -msgid "To see an example of a batch being used, take a look at <literal>/examples/remoting/chatroom</literal>." +msgid "" +"To see an example of a batch being used, take a look at <literal>/examples/" +"remoting/chatroom</literal>." msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "Lavorare con i tipi di dati" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format -msgid "This section describes the support for basic data types. On the server side these values are generally compatible with either their primitive type or their corresponding wrapper class." +msgid "" +"This section describes the support for basic data types. On the server side " +"these values are generally compatible with either their primitive type or " +"their corresponding wrapper class." msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "String" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format -msgid "Simply use Javascript String objects when setting String parameter values." +msgid "" +"Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "Number" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format -msgid "There is support for all number types supported by Java. On the client side, number values are always serialized as their String representation and then on the server side they are converted to the correct destination type. Conversion into either a primitive or wrapper type is supported for <literal>Byte</literal>, <literal>Double</literal>, <literal>Float</literal>, <literal>Integer</literal>, <literal>Long</literal> and <literal>Short</literal> types." +msgid "" +"There is support for all number types supported by Java. On the client side, " +"number values are always serialized as their String representation and then " +"on the server side they are converted to the correct destination type. " +"Conversion into either a primitive or wrapper type is supported for " +"<literal>Byte</literal>, <literal>Double</literal>, <literal>Float</" +"literal>, <literal>Integer</literal>, <literal>Long</literal> and " +"<literal>Short</literal> types." msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "Boolean" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format -msgid "Booleans are represented client side by Javascript Boolean values, and server side by a Java boolean." +msgid "" +"Booleans are represented client side by Javascript Boolean values, and " +"server side by a Java boolean." msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "JavaBeans" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format -msgid "In general these will be either Seam entity or JavaBean components, or some other non-component class. Use the appropriate method (either <literal>Seam.Component.newInstance()</literal> for Seam components or <literal>Seam.Remoting.createType()</literal> for everything else) to create a new instance of the object." +msgid "" +"In general these will be either Seam entity or JavaBean components, or some " +"other non-component class. Use the appropriate method (either <literal>Seam." +"Component.newInstance()</literal> for Seam components or <literal>Seam." +"Remoting.createType()</literal> for everything else) to create a new " +"instance of the object." msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format -msgid "It is important to note that only objects that are created by either of these two methods should be used as parameter values, where the parameter is not one of the other valid types mentioned anywhere else in this section. In some situations you may have a component method where the exact parameter type cannot be determined, such as:" +msgid "" +"It is important to note that only objects that are created by either of " +"these two methods should be used as parameter values, where the parameter is " +"not one of the other valid types mentioned anywhere else in this section. In " +"some situations you may have a component method where the exact parameter " +"type cannot be determined, such as:" msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -767,49 +1090,70 @@ "}" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format -msgid "In this case you might want to pass in an instance of your <literal>myWidget</literal> component, however the interface for <literal>myAction</literal> won't include <literal>myWidget</literal> as it is not directly referenced by any of its methods. To get around this, <literal>MyWidget</literal> needs to be explicitly imported:" +msgid "" +"In this case you might want to pass in an instance of your " +"<literal>myWidget</literal> component, however the interface for " +"<literal>myAction</literal> won't include <literal>myWidget</literal> as it " +"is not directly referenced by any of its methods. To get around this, " +"<literal>MyWidget</literal> needs to be explicitly imported:" msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format -msgid "This will then allow a <literal>myWidget</literal> object to be created with <literal>Seam.Component.newInstance(\"myWidget\")</literal>, which can then be passed to <literal>myAction.doSomethingWithObject()</literal>." +msgid "" +"This will then allow a <literal>myWidget</literal> object to be created with " +"<literal>Seam.Component.newInstance(\"myWidget\")</literal>, which can then " +"be passed to <literal>myAction.doSomethingWithObject()</literal>." msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "Date e orari" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format -msgid "Date values are serialized into a String representation that is accurate to the millisecond. On the client side, use a Javascript Date object to work with date values. On the server side, use any <literal>java.util.Date</literal> (or descendent, such as <literal>java.sql.Date</literal> or <literal>java.sql.Timestamp</literal> class." -msgstr "I valori delle date sono serializzati in una rappresentazione di Strina che è accurata al millisecondo. Lato client, si usi un oggetto Date Javascript per lavorare con i valori delle date. Late server, si usi <literal>java.util.Date</literal> (o discendenti, come le classi <literal>java.sql.Date</literal> o <literal>java.sql.Timestamp</literal>)." +msgid "" +"Date values are serialized into a String representation that is accurate to " +"the millisecond. On the client side, use a Javascript Date object to work " +"with date values. On the server side, use any <literal>java.util.Date</" +"literal> (or descendent, such as <literal>java.sql.Date</literal> or " +"<literal>java.sql.Timestamp</literal> class." +msgstr "" +"I valori delle date sono serializzati in una rappresentazione di Strina che " +"è accurata al millisecondo. Lato client, si usi un oggetto Date Javascript " +"per lavorare con i valori delle date. Late server, si usi <literal>java.util." +"Date</literal> (o discendenti, come le classi <literal>java.sql.Date</" +"literal> o <literal>java.sql.Timestamp</literal>)." #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "Enums" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format -msgid "On the client side, enums are treated the same as Strings. When setting the value for an enum parameter, simply use the String representation of the enum. Take the following component as an example:" +msgid "" +"On the client side, enums are treated the same as Strings. When setting the " +"value for an enum parameter, simply use the String representation of the " +"enum. Take the following component as an example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -831,191 +1175,255 @@ "}" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format -msgid "To call the <literal>paint()</literal> method with the color <literal>red</literal>, pass the parameter value as a String literal:" +msgid "" +"To call the <literal>paint()</literal> method with the color <literal>red</" +"literal>, pass the parameter value as a String literal:" msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format -msgid "The inverse is also true - that is, if a component method returns an enum parameter (or contains an enum field anywhere in the returned object graph) then on the client-side it will be represented as a String." +msgid "" +"The inverse is also true - that is, if a component method returns an enum " +"parameter (or contains an enum field anywhere in the returned object graph) " +"then on the client-side it will be represented as a String." msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "Collections" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "Bags" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format -msgid "Bags cover all collection types including arrays, collections, lists, sets, (but excluding Maps - see the next section for those), and are implemented client-side as a Javascript array. When calling a component method that accepts one of these types as a parameter, your parameter should be a Javascript array. If a component method returns one of these types, then the return value will also be a Javascript array. The remoting framework is clever enough on the server side to convert the bag to an appropriate type for the component method call." +msgid "" +"Bags cover all collection types including arrays, collections, lists, sets, " +"(but excluding Maps - see the next section for those), and are implemented " +"client-side as a Javascript array. When calling a component method that " +"accepts one of these types as a parameter, your parameter should be a " +"Javascript array. If a component method returns one of these types, then the " +"return value will also be a Javascript array. The remoting framework is " +"clever enough on the server side to convert the bag to an appropriate type " +"for the component method call." msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "Maps" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format -msgid "As there is no native support for Maps within Javascript, a simple Map implementation is provided with the Seam Remoting framework. To create a Map which can be used as a parameter to a remote call, create a new <literal>Seam.Remoting.Map</literal> object:" +msgid "" +"As there is no native support for Maps within Javascript, a simple Map " +"implementation is provided with the Seam Remoting framework. To create a Map " +"which can be used as a parameter to a remote call, create a new " +"<literal>Seam.Remoting.Map</literal> object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "var map = new Seam.Remoting.Map();" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format -msgid "This Javascript implementation provides basic methods for working with Maps: <literal>size()</literal>, <literal>isEmpty()</literal>, <literal>keySet()</literal>, <literal>values()</literal>, <literal>get(key)</literal>, <literal>put(key, value)</literal>, <literal>remove(key)</literal> and <literal>contains(key)</literal>. Each of these methods are equivalent to their Java counterpart. Where the method returns a collection, such as <literal>keySet()</literal> and <literal>values()</literal>, a Javascript Array object will be returned that contains the key or value objects (respectively)." +msgid "" +"This Javascript implementation provides basic methods for working with Maps: " +"<literal>size()</literal>, <literal>isEmpty()</literal>, <literal>keySet()</" +"literal>, <literal>values()</literal>, <literal>get(key)</literal>, " +"<literal>put(key, value)</literal>, <literal>remove(key)</literal> and " +"<literal>contains(key)</literal>. Each of these methods are equivalent to " +"their Java counterpart. Where the method returns a collection, such as " +"<literal>keySet()</literal> and <literal>values()</literal>, a Javascript " +"Array object will be returned that contains the key or value objects " +"(respectively)." msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "Debugging" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format -msgid "To aid in tracking down bugs, it is possible to enable a debug mode which will display the contents of all the packets send back and forth between the client and server in a popup window. To enable debug mode, either execute the <literal>setDebug()</literal> method in Javascript:" +msgid "" +"To aid in tracking down bugs, it is possible to enable a debug mode which " +"will display the contents of all the packets send back and forth between the " +"client and server in a popup window. To enable debug mode, either execute " +"the <literal>setDebug()</literal> method in Javascript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "Seam.Remoting.setDebug(true);" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "O lo si configuri via components.xml:" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format -msgid "To turn off debugging, call <literal>setDebug(false)</literal>. If you want to write your own messages to the debug log, call <literal>Seam.Remoting.log(message)</literal>." +msgid "" +"To turn off debugging, call <literal>setDebug(false)</literal>. If you want " +"to write your own messages to the debug log, call <literal>Seam.Remoting.log" +"(message)</literal>." msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "Gestione delle eccezioni" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format -msgid "When invoking a remote component method, it is possible to specify an exception handler which will process the response in the event of an exception during component invocation. To specify an exception handler function, include a reference to it after the callback parameter in your JavaScript:" +msgid "" +"When invoking a remote component method, it is possible to specify an " +"exception handler which will process the response in the event of an " +"exception during component invocation. To specify an exception handler " +"function, include a reference to it after the callback parameter in your " +"JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" -"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, exceptionHandler);]]>" +"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex." +"getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, " +"exceptionHandler);]]>" msgstr "" "<![CDATA[var callback = function(result) { alert(result); };\n" -"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, exceptionHandler);]]>" +"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex." +"getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, " +"exceptionHandler);]]>" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format -msgid "If you do not have a callback handler defined, you must specify <literal>null</literal> in its place:" +msgid "" +"If you do not have a callback handler defined, you must specify " +"<literal>null</literal> in its place:" msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" -"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, exceptionHandler);]]>" +"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " +"occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, " +"exceptionHandler);]]>" msgstr "" -"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, exceptionHandler);]]>" +"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " +"occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, " +"exceptionHandler);]]>" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format -msgid "The exception object that is passed to the exception handler exposes one method, <literal>getMessage()</literal> that returns the exception message which is produced by the exception thrown by the <literal>@WebRemote</literal> method." +msgid "" +"The exception object that is passed to the exception handler exposes one " +"method, <literal>getMessage()</literal> that returns the exception message " +"which is produced by the exception thrown by the <literal>@WebRemote</" +"literal> method." msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "Il messaggio di caricamento" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format -msgid "The default loading message that appears in the top right corner of the screen can be modified, its rendering customised or even turned off completely." +msgid "" +"The default loading message that appears in the top right corner of the " +"screen can be modified, its rendering customised or even turned off " +"completely." msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "Cambiare il messaggio" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format -msgid "To change the message from the default \"Please Wait...\" to something different, set the value of <literal>Seam.Remoting.loadingMessage</literal>:" -msgstr "Per cambiare il messaggio dal default \"Attendere prego...\" a qualcosa di differente, si imposti il valore di <literal>Seam.Remoting.loadingMessage</literal>:" +msgid "" +"To change the message from the default \"Please Wait...\" to something " +"different, set the value of <literal>Seam.Remoting.loadingMessage</literal>:" +msgstr "" +"Per cambiare il messaggio dal default \"Attendere prego...\" a qualcosa di " +"differente, si imposti il valore di <literal>Seam.Remoting.loadingMessage</" +"literal>:" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "Seam.Remoting.loadingMessage = \"Loading...\";" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "Nascondere il messaggio di caricamento" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format -msgid "To completely suppress the display of the loading message, override the implementation of <literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()</literal> with functions that instead do nothing:" +msgid "" +"To completely suppress the display of the loading message, override the " +"implementation of <literal>displayLoadingMessage()</literal> and " +"<literal>hideLoadingMessage()</literal> with functions that instead do " +"nothing:" msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1027,19 +1435,23 @@ "Seam.Remoting.hideLoadingMessage = function() {};" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format -msgid "It is also possible to override the loading indicator to display an animated icon, or anything else that you want. To do this override the <literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()</literal> messages with your own implementation:" +msgid "" +"It is also possible to override the loading indicator to display an animated " +"icon, or anything else that you want. To do this override the " +"<literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()" +"</literal> messages with your own implementation:" msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1059,31 +1471,49 @@ " };" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format -msgid "When a remote method is executed, the result is serialized into an XML response that is returned to the client. This response is then unmarshaled by the client into a Javascript object. For complex types (i.e. Javabeans) that include references to other objects, all of these referenced objects are also serialized as part of the response. These objects may reference other objects, which may reference other objects, and so forth. If left unchecked, this object \"graph\" could potentially be enormous, depending on what relationships exist between your objects. And as a side issue (besides the potential verbosity of the response), you might also wish to prevent sensitive information from being exposed to the client." +msgid "" +"When a remote method is executed, the result is serialized into an XML " +"response that is returned to the client. This response is then unmarshaled " +"by the client into a Javascript object. For complex types (i.e. Javabeans) " +"that include references to other objects, all of these referenced objects " +"are also serialized as part of the response. These objects may reference " +"other objects, which may reference other objects, and so forth. If left " +"unchecked, this object \"graph\" could potentially be enormous, depending on " +"what relationships exist between your objects. And as a side issue (besides " +"the potential verbosity of the response), you might also wish to prevent " +"sensitive information from being exposed to the client." msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format -msgid "Seam Remoting provides a simple means to \"constrain\" the object graph, by specifying the <literal>exclude</literal> field of the remote method's <literal>@WebRemote</literal> annotation. This field accepts a String array containing one or more paths specified using dot notation. When invoking a remote method, the objects in the result's object graph that match these paths are excluded from the serialized result packet." +msgid "" +"Seam Remoting provides a simple means to \"constrain\" the object graph, by " +"specifying the <literal>exclude</literal> field of the remote method's " +"<literal>@WebRemote</literal> annotation. This field accepts a String array " +"containing one or more paths specified using dot notation. When invoking a " +"remote method, the objects in the result's object graph that match these " +"paths are excluded from the serialized result packet." msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format -msgid "For all our examples, we'll use the following <literal>Widget</literal> class:" +msgid "" +"For all our examples, we'll use the following <literal>Widget</literal> " +"class:" msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1111,19 +1541,22 @@ "}" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format -msgid "If your remote method returns an instance of <literal>Widget</literal>, but you don't want to expose the <literal>secret</literal> field because it contains sensitive information, you would constrain it like this:" +msgid "" +"If your remote method returns an instance of <literal>Widget</literal>, but " +"you don't want to expose the <literal>secret</literal> field because it " +"contains sensitive information, you would constrain it like this:" msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1133,13 +1566,21 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format -msgid "The value \"secret\" refers to the <literal>secret</literal> field of the returned object. Now, suppose that we don't care about exposing this particular field to the client. Instead, notice that the <literal>Widget</literal> value that is returned has a field <literal>child</literal> that is also a <literal>Widget</literal>. What if we want to hide the <literal>child</literal>'s <literal>secret</literal> value instead? We can do this by using dot notation to specify this field's path within the result's object graph:" +msgid "" +"The value \"secret\" refers to the <literal>secret</literal> field of the " +"returned object. Now, suppose that we don't care about exposing this " +"particular field to the client. Instead, notice that the <literal>Widget</" +"literal> value that is returned has a field <literal>child</literal> that is " +"also a <literal>Widget</literal>. What if we want to hide the " +"<literal>child</literal>'s <literal>secret</literal> value instead? We can " +"do this by using dot notation to specify this field's path within the " +"result's object graph:" msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1149,19 +1590,27 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format -msgid "The other place that objects can exist within an object graph are within a <literal>Map</literal> or some kind of collection (<literal>List</literal>, <literal>Set</literal>, <literal>Array</literal>, etc). Collections are easy, and are treated like any other field. For example, if our <literal>Widget</literal> contained a list of other <literal>Widget</literal>s in its <literal>widgetList</literal> field, to constrain the <literal>secret</literal> field of the <literal>Widget</literal>s in this list the annotation would look like this:" +msgid "" +"The other place that objects can exist within an object graph are within a " +"<literal>Map</literal> or some kind of collection (<literal>List</literal>, " +"<literal>Set</literal>, <literal>Array</literal>, etc). Collections are " +"easy, and are treated like any other field. For example, if our " +"<literal>Widget</literal> contained a list of other <literal>Widget</" +"literal>s in its <literal>widgetList</literal> field, to constrain the " +"<literal>secret</literal> field of the <literal>Widget</literal>s in this " +"list the annotation would look like this:" msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1171,13 +1620,20 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format -msgid "To constrain a <literal>Map</literal>'s key or value, the notation is slightly different. Appending <literal>[key]</literal> after the <literal>Map</literal>'s field name will constrain the <literal>Map</literal>'s key object values, while <literal>[value]</literal> will constrain the value object values. The following example demonstrates how the values of the <literal>widgetMap</literal> field have their <literal>secret</literal> field constrained:" +msgid "" +"To constrain a <literal>Map</literal>'s key or value, the notation is " +"slightly different. Appending <literal>[key]</literal> after the " +"<literal>Map</literal>'s field name will constrain the <literal>Map</" +"literal>'s key object values, while <literal>[value]</literal> will " +"constrain the value object values. The following example demonstrates how " +"the values of the <literal>widgetMap</literal> field have their " +"<literal>secret</literal> field constrained:" msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1187,19 +1643,24 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format -msgid "There is one last notation that can be used to constrain the fields of a type of object no matter where in the result's object graph it appears. This notation uses either the name of the component (if the object is a Seam component) or the fully qualified class name (only if the object is not a Seam component) and is expressed using square brackets:" +msgid "" +"There is one last notation that can be used to constrain the fields of a " +"type of object no matter where in the result's object graph it appears. This " +"notation uses either the name of the component (if the object is a Seam " +"component) or the fully qualified class name (only if the object is not a " +"Seam component) and is expressed using square brackets:" msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1209,19 +1670,21 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format -msgid "Constraints can also be combined, to filter objects from multiple paths within the object graph:" +msgid "" +"Constraints can also be combined, to filter objects from multiple paths " +"within the object graph:" msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1231,19 +1694,23 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "Richieste transazionali" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format -msgid "By default there is no active transaction during a remoting request, so if you wish to perform database updates during a remoting request, you need to annotate the <literal>@WebRemote</literal> method with <literal>@Transactional</literal>, like so:" +msgid "" +"By default there is no active transaction during a remoting request, so if " +"you wish to perform database updates during a remoting request, you need to " +"annotate the <literal>@WebRemote</literal> method with " +"<literal>@Transactional</literal>, like so:" msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1253,44 +1720,53 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "Messaggistica JMS" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format -msgid "Seam Remoting provides experimental support for JMS Messaging. This section describes the JMS support that is currently implemented, but please note that this may change in the future. It is currently not recommended that this feature is used within a production environment." +msgid "" +"Seam Remoting provides experimental support for JMS Messaging. This section " +"describes the JMS support that is currently implemented, but please note " +"that this may change in the future. It is currently not recommended that " +"this feature is used within a production environment." msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format -msgid "Before you can subscribe to a JMS topic, you must first configure a list of the topics that can be subscribed to by Seam Remoting. List the topics under <literal>org.jboss.seam.remoting.messaging.subscriptionRegistry.allowedTopics</literal> in <literal>seam.properties</literal>, <literal>web.xml</literal> or <literal>components.xml</literal>." +msgid "" +"Before you can subscribe to a JMS topic, you must first configure a list of " +"the topics that can be subscribed to by Seam Remoting. List the topics under " +"<literal>org.jboss.seam.remoting.messaging.subscriptionRegistry." +"allowedTopics</literal> in <literal>seam.properties</literal>, <literal>web." +"xml</literal> or <literal>components.xml</literal>." msgstr "" #. Tag: programlisting -#: Remoting.xml:606 -#: Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" -msgstr "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" +msgstr "" +"<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "Iscriversi ad un Topic JMS" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1310,90 +1786,125 @@ "Seam.Remoting.subscribe(\"topicName\", subscriptionCallback);" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format -msgid "The <literal>Seam.Remoting.subscribe()</literal> method accepts two parameters, the first being the name of the JMS Topic to subscribe to, the second being the callback function to invoke when a message is received." +msgid "" +"The <literal>Seam.Remoting.subscribe()</literal> method accepts two " +"parameters, the first being the name of the JMS Topic to subscribe to, the " +"second being the callback function to invoke when a message is received." msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format -msgid "There are two types of messages supported, Text messages and Object messages. If you need to test for the type of message that is passed to your callback function you can use the <literal>instanceof</literal> operator to test whether the message is a <literal>Seam.Remoting.TextMessage</literal> or <literal>Seam.Remoting.ObjectMessage</literal>. A <literal>TextMessage</literal> contains the text value in its <literal>text</literal> field (or alternatively call <literal>getText()</literal> on it), while an <literal>ObjectMessage</literal> contains its object value in its <literal>value</literal> field (or call its <literal>getValue()</literal> method)." +msgid "" +"There are two types of messages supported, Text messages and Object " +"messages. If you need to test for the type of message that is passed to your " +"callback function you can use the <literal>instanceof</literal> operator to " +"test whether the message is a <literal>Seam.Remoting.TextMessage</literal> " +"or <literal>Seam.Remoting.ObjectMessage</literal>. A <literal>TextMessage</" +"literal> contains the text value in its <literal>text</literal> field (or " +"alternatively call <literal>getText()</literal> on it), while an " +"<literal>ObjectMessage</literal> contains its object value in its " +"<literal>value</literal> field (or call its <literal>getValue()</literal> " +"method)." msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "Disiscriversi da un Topic" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format -msgid "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</literal> and pass in the topic name:" +msgid "" +"To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" +"literal> and pass in the topic name:" msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "Seam.Remoting.unsubscribe(\"topicName\");" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format -msgid "There are two parameters which you can modify to control how polling occurs. The first one is <literal>Seam.Remoting.pollInterval</literal>, which controls how long to wait between subsequent polls for new messages. This parameter is expressed in seconds, and its default setting is 10." +msgid "" +"There are two parameters which you can modify to control how polling occurs. " +"The first one is <literal>Seam.Remoting.pollInterval</literal>, which " +"controls how long to wait between subsequent polls for new messages. This " +"parameter is expressed in seconds, and its default setting is 10." msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format -msgid "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is also expressed as seconds. It controls how long a request to the server should wait for a new message before timing out and sending an empty response. Its default is 0 seconds, which means that when the server is polled, if there are no messages ready for delivery then an empty response will be immediately returned." +msgid "" +"The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " +"also expressed as seconds. It controls how long a request to the server " +"should wait for a new message before timing out and sending an empty " +"response. Its default is 0 seconds, which means that when the server is " +"polled, if there are no messages ready for delivery then an empty response " +"will be immediately returned." msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format -msgid "Caution should be used when setting a high <literal>pollTimeout</literal> value; each request that has to wait for a message means that a server thread is tied up until a message is received, or until the request times out. If many such requests are being served simultaneously, it could mean a large number of threads become tied up because of this reason." +msgid "" +"Caution should be used when setting a high <literal>pollTimeout</literal> " +"value; each request that has to wait for a message means that a server " +"thread is tied up until a message is received, or until the request times " +"out. If many such requests are being served simultaneously, it could mean a " +"large number of threads become tied up because of this reason." msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format -msgid "It is recommended that you set these options via components.xml, however they can be overridden via Javascript if desired. The following example demonstrates how to configure the polling to occur much more aggressively. You should set these parameters to suitable values for your application:" +msgid "" +"It is recommended that you set these options via components.xml, however " +"they can be overridden via Javascript if desired. The following example " +"demonstrates how to configure the polling to occur much more aggressively. " +"You should set these parameters to suitable values for your application:" msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "Via components.xml:" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "Via JavaScript:" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" -"// Only wait 1 second between receiving a poll response and sending the next poll request.\n" +"// Only wait 1 second between receiving a poll response and sending the next " +"poll request.\n" "Seam.Remoting.pollInterval = 1;\n" " \n" "// Wait up to 5 seconds on the server for new messages\n" "Seam.Remoting.pollTimeout = 5;" msgstr "" -"// Attendere 1 secondo tra la ricezione della risposta del pool e l'invio della successiva richiesta di pool.\n" +"// Attendere 1 secondo tra la ricezione della risposta del pool e l'invio " +"della successiva richiesta di pool.\n" "Seam.Remoting.pollInterval = 1;\n" " \n" "// Attendere fino a 5 secondi sul server per nuovi messaggi\n" "Seam.Remoting.pollTimeout = 5;" -

16 years, 11 months

1
0
0 / 0

Seam SVN: r10945 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-23 07:50:59 -0400 (Sat, 23 May 2009) New Revision: 10945 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po 2009-05-23 11:50:59 UTC (rev 10945) @@ -5,9 +5,9 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-23 11:30+0000\n" -"PO-Revision-Date: 2009-03-17 21:41+0100\n" -"Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" +"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"PO-Revision-Date: 2009-05-23 13:44+0100\n" +"Last-Translator: Francesco Milesi <milesif(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -22,25 +22,12 @@ #. Tag: para #: Remoting.xml:6 #, no-c-format -msgid "" -"Seam provides a convenient method of remotely accessing components from a " -"web page, using AJAX (Asynchronous Javascript and XML). The framework for " -"this functionality is provided with almost no up-front development effort - " -"your components only require simple annotating to become accessible via " -"AJAX. This chapter describes the steps required to build an AJAX-enabled web " -"page, then goes on to explain the features of the Seam Remoting framework in " -"more detail." -msgstr "" -"Seam fornisce un metodo per accedere in modo remoto i componenti da una " -"pagina web, usando AJAX (Asynchronous Javascript and XML). Il framework per " -"questa funzionalità viene fornito con quasi nessuno sforzo di sviluppo - i " -"componenti richiedono solamente una semplice annotazione per diventare " -"accessibile via AJAX. Questo capitolo descrive i passi richiesti per " -"costruire una pagina web abilitata a AJAX, poi spiega con maggior dettaglio " -"le caratteristiche del framework Seam Remoting." +msgid "Seam provides a convenient method of remotely accessing components from a web page, using AJAX (Asynchronous Javascript and XML). The framework for this functionality is provided with almost no up-front development effort - your components only require simple annotating to become accessible via AJAX. This chapter describes the steps required to build an AJAX-enabled web page, then goes on to explain the features of the Seam Remoting framework in more detail." +msgstr "Seam fornisce un metodo per accedere in modo remoto i componenti da una pagina web, usando AJAX (Asynchronous Javascript and XML). Il framework per questa funzionalità viene fornito con quasi nessuno sforzo di sviluppo - i componenti richiedono solamente una semplice annotazione per diventare accessibile via AJAX. Questo capitolo descrive i passi richiesti per costruire una pagina web abilitata a AJAX, poi spiega con maggior dettaglio le caratteristiche del framework Seam Remoting." #. Tag: title -#: Remoting.xml:13 Remoting.xml:608 +#: Remoting.xml:13 +#: Remoting.xml:599 #, no-c-format msgid "Configuration" msgstr "Configurazione" @@ -48,12 +35,8 @@ #. Tag: para #: Remoting.xml:14 #, no-c-format -msgid "" -"To use remoting, the Seam Resource servlet must first be configured in your " -"<literal>web.xml</literal> file:" -msgstr "" -"Per usare remoting, il resource servlet di Seam deve essere innanzitutto " -"configurato nel file <literal>web.xml</literal>:" +msgid "To use remoting, the Seam Resource servlet must first be configured in your <literal>web.xml</literal> file:" +msgstr "Per usare remoting, il resource servlet di Seam deve essere innanzitutto configurato nel file <literal>web.xml</literal>:" #. Tag: programlisting #: Remoting.xml:16 @@ -82,92 +65,52 @@ #. Tag: para #: Remoting.xml:18 #, no-c-format -msgid "" -"The next step is to import the necessary Javascript into your web page. " -"There are a minimum of two scripts that must be imported. The first one " -"contains all the client-side framework code that enables remoting " -"functionality:" -msgstr "" -"Il passo successivi è importare il Javascript necessario nella propria " -"pagina web. Ci sono un minimo di due script da importare. Il primo contiene " -"tutto il codice del framework lato client che abilita le funzionalità di " -"remoting:" +msgid "The next step is to import the necessary Javascript into your web page. There are a minimum of two scripts that must be imported. The first one contains all the client-side framework code that enables remoting functionality:" +msgstr "Il passo successivi è importare il Javascript necessario nella propria pagina web. Ci sono un minimo di due script da importare. Il primo contiene tutto il codice del framework lato client che abilita le funzionalità di remoting:" #. Tag: programlisting #: Remoting.xml:22 #, no-c-format -msgid "" -"<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/" -"resource/remote.js\"></script>]]>" -msgstr "" -"<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/" -"resource/remote.js\"></script>]]>" +msgid "<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/resource/remote.js\"></script>]]>" +msgstr "<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/resource/remote.js\"></script>]]>" #. Tag: para #: Remoting.xml:24 #, no-c-format -msgid "" -"The second script contains the stubs and type definitions for the components " -"you wish to call. It is generated dynamically based on the local interface " -"of your components, and includes type definitions for all of the classes " -"that can be used to call the remotable methods of the interface. The name of " -"the script reflects the name of your component. For example, if you have a " -"stateless session bean annotated with <literal>@Name(\"customerAction\")</" -"literal>, then your script tag should look like this:" -msgstr "" -"Il secondo script contiene gli stub e le definizioni tipo per i componenti " -"da chiamare. Viene generato dinamicamente basandosi sull'interfaccia locale " -"dei propri componenti, ed include le definizioni tipo per tutte le classi " -"che possono essere usate per chiamare i metodi remoti dell'interfaccia. Il " -"nome dello script riflette il nome del componente. Per esempio se si ha un " -"bean di sessione stateless annotato con <literal>@Name(\"customerAction\")</" -"literal>, allora il tag dello script dovrebbe essere simile a:" +msgid "The second script contains the stubs and type definitions for the components you wish to call. It is generated dynamically based on the local interface of your components, and includes type definitions for all of the classes that can be used to call the remotable methods of the interface. The name of the script reflects the name of your component. For example, if you have a stateless session bean annotated with <literal>@Name(\"customerAction\")</literal>, then your script tag should look like this:" +msgstr "Il secondo script contiene gli stub e le definizioni tipo per i componenti da chiamare. Viene generato dinamicamente basandosi sull'interfaccia locale dei propri componenti, ed include le definizioni tipo per tutte le classi che possono essere usate per chiamare i metodi remoti dell'interfaccia. Il nome dello script riflette il nome del componente. Per esempio se si ha un bean di sessione stateless annotato con <literal>@Name(\"customerAction\")</literal>, allora il tag dello script dovrebbe essere simile a:" #. Tag: programlisting #: Remoting.xml:30 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></" -"script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></" -"script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" #. Tag: para #: Remoting.xml:32 #, no-c-format -msgid "" -"If you wish to access more than one component from the same page, then " -"include them all as parameters of your script tag:" -msgstr "" -"Se si vuole accedere a più di un componente dalla stessa pagina, allora li " -"si includa tutti come parametri nel tag script:" +msgid "If you wish to access more than one component from the same page, then include them all as parameters of your script tag:" +msgstr "Se si vuole accedere a più di un componente dalla stessa pagina, allora li si includa tutti come parametri nel tag script:" #. Tag: programlisting #: Remoting.xml:35 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?" -"customerAction&accountAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction&accountAction\"></script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?" -"customerAction&accountAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction&accountAction\"></script>]]>" #. Tag: para #: Remoting.xml:38 #, no-c-format -msgid "" -"Alternatively, you may use the <literal>s:remote</literal> tag to import the " -"required Javascript. Separate each component or class name you wish to " -"import with a comma:" -msgstr "" -"In alternativa si può usare il tag <literal>s:remote</literal> per importare " -"il Javascript richiesto. Si separi ciascun componente o nome di classe che " -"si vuole importare con una virgola:" +msgid "Alternatively, you may use the <literal>s:remote</literal> tag to import the required Javascript. Separate each component or class name you wish to import with a comma:" +msgstr "In alternativa si può usare il tag <literal>s:remote</literal> per importare il Javascript richiesto. Si separi ciascun componente o nome di classe che si vuole importare con una virgola:" #. Tag: programlisting #: Remoting.xml:43 @@ -190,24 +133,8 @@ #. Tag: para #: Remoting.xml:50 #, no-c-format -msgid "" -"Client-side interaction with your components is all performed via the " -"<literal>Seam</literal> Javascript object. This object is defined in " -"<literal>remote.js</literal>, and you'll be using it to make asynchronous " -"calls against your component. It is split into two areas of functionality; " -"<literal>Seam.Component</literal> contains methods for working with " -"components and <literal>Seam.Remoting</literal> contains methods for " -"executing remote requests. The easiest way to become familiar with this " -"object is to start with a simple example." -msgstr "" -"L'interazione lato client con i componenti viene eseguita tutta tramite " -"l'oggetto Javascript <literal>Seam</literal>. Quest'oggetti è definito in " -"<literal>remote.js</literal>, e lo si userà per fare chiamate asincrone " -"verso il componente. E' suddiviso in due aree di funzionalità; <literal>Seam." -"Component</literal> contiene metodi per lavorare con i componenti e " -"<literal>Seam.Remoting</literal> contiene metodi per eseguire le richieste " -"remote. La via più facile per diventare familiare con quest'oggetto è " -"cominciare con un semplice esempio." +msgid "Client-side interaction with your components is all performed via the <literal>Seam</literal> Javascript object. This object is defined in <literal>remote.js</literal>, and you'll be using it to make asynchronous calls against your component. It is split into two areas of functionality; <literal>Seam.Component</literal> contains methods for working with components and <literal>Seam.Remoting</literal> contains methods for executing remote requests. The easiest way to become familiar with this object is to start with a simple example." +msgstr "L'interazione lato client con i componenti viene eseguita tutta tramite l'oggetto Javascript <literal>Seam</literal>. Quest'oggetti è definito in <literal>remote.js</literal>, e lo si userà per fare chiamate asincrone verso il componente. E' suddiviso in due aree di funzionalità; <literal>Seam.Component</literal> contiene metodi per lavorare con i componenti e <literal>Seam.Remoting</literal> contiene metodi per eseguire le richieste remote. La via più facile per diventare familiare con quest'oggetto è cominciare con un semplice esempio." #. Tag: title #: Remoting.xml:57 @@ -218,13 +145,8 @@ #. Tag: para #: Remoting.xml:59 #, no-c-format -msgid "" -"Let's step through a simple example to see how the <literal>Seam</literal> " -"object works. First of all, let's create a new Seam component called " -"<literal>helloAction</literal>." -msgstr "" -"Si cominci con un semplice esempio per vedere come funziona l'oggetto " -"<literal>Seam</literal>" +msgid "Let's step through a simple example to see how the <literal>Seam</literal> object works. First of all, let's create a new Seam component called <literal>helloAction</literal>." +msgstr "Si cominci con un semplice esempio per vedere come funziona l'oggetto <literal>Seam</literal>" #. Tag: programlisting #: Remoting.xml:62 @@ -249,11 +171,8 @@ #. Tag: para #: Remoting.xml:64 #, no-c-format -msgid "" -"You also need to create a local interface for our new component - take " -"special note of the <literal>@WebRemote</literal> annotation, as it's " -"required to make our method accessible via remoting:" -msgstr "" +msgid "You also need to create a local interface for our new component - take special note of the <literal>@WebRemote</literal> annotation, as it's required to make our method accessible via remoting:" +msgstr "E' anche necessario creare un'interfaccia locale per il nuovo componente - tenete a mente in particolare l'annotazione <literal>@WebRemote</literal>, poiché è necessaria a rendere un metodo accessibile via remoting:" #. Tag: programlisting #: Remoting.xml:67 @@ -274,61 +193,35 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format -msgid "That's all the server-side code we need to write." -msgstr "" +msgid "That's all the server-side code we need to write. Now for our web page - create a new page and import the <literal>helloAction</literal> component:" +msgstr "Questo è tutto il codice lato server che bisogna scrivere. Ora, per quantro riguarda la pagina web - bisogna creare una nuova pagina e importare il componente <literal>helloAction</literal>:" -#. Tag: para +#. Tag: programlisting #: Remoting.xml:72 #, no-c-format -msgid "" -"If you are performing a persistence operation in the method marked " -"<literal>@WebRemote</literal> you will also need to add a " -"<literal>@Transactional</literal> annotation to the method. Otherwise, your " -"method would execute outside of a transaction without this extra hint.That's " -"because unlike a JSF request, Seam does not wrap the remoting request in a " -"transaction automatically." -msgstr "" - -#. Tag: para -#: Remoting.xml:78 -#, no-c-format -msgid "" -"Now for our web page - create a new page and import the " -"<literal>helloAction</literal> component:" -msgstr "" - -#. Tag: programlisting -#: Remoting.xml:81 -#, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"helloAction\"/>]]>" #. Tag: para -#: Remoting.xml:83 +#: Remoting.xml:74 #, no-c-format -msgid "" -"To make this a fully interactive user experience, let's add a button to our " -"page:" -msgstr "" +msgid "To make this a fully interactive user experience, let's add a button to our page:" +msgstr "Per rendere l'esperienza dell'utente veramente interattiva, si aggiunga un bottone alla pagina:" #. Tag: programlisting -#: Remoting.xml:85 +#: Remoting.xml:76 #, no-c-format -msgid "" -"<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" -msgstr "" -"<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" +msgid "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" +msgstr "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:78 #, no-c-format -msgid "" -"We'll also need to add some more script to make our button actually do " -"something when it's clicked:" -msgstr "" +msgid "We'll also need to add some more script to make our button actually do something when it's clicked:" +msgstr "Bisognerà anche aggiungere uno script per far fare qualcosa al bottone quando viene cliccato:" #. Tag: programlisting -#: Remoting.xml:89 +#: Remoting.xml:80 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -336,8 +229,7 @@ "\n" " function sayHello() {\n" " var name = prompt(\"What is your name?\");\n" -" Seam.Component.getInstance(\"helloAction\").sayHello(name, " -"sayHelloCallback);\n" +" Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);\n" " }\n" "\n" " function sayHelloCallback(result) {\n" @@ -352,8 +244,7 @@ "\n" " function sayHello() {\n" " var name = prompt(\"What is your name?\");\n" -" Seam.Component.getInstance(\"helloAction\").sayHello(name, " -"sayHelloCallback);\n" +" Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);\n" " }\n" "\n" " function sayHelloCallback(result) {\n" @@ -364,108 +255,67 @@ "</script>]]>" #. Tag: para -#: Remoting.xml:91 +#: Remoting.xml:82 #, no-c-format -msgid "" -"We're done! Deploy your application and browse to your page. Click the " -"button, and enter a name when prompted. A message box will display the hello " -"message confirming that the call was successful. If you want to save some " -"time, you'll find the full source code for this Hello World example in " -"Seam's <literal>/examples/remoting/helloworld</literal> directory." -msgstr "" +msgid "We're done! Deploy your application and browse to your page. Click the button, and enter a name when prompted. A message box will display the hello message confirming that the call was successful. If you want to save some time, you'll find the full source code for this Hello World example in Seam's <literal>/examples/remoting/helloworld</literal> directory." +msgstr "Abbiamo finito! Installate l'applicazione e andate col browser alla pagina creata. Premete il pulsante e inserite un nome quando richiesto. Una finestra mostrerà il messaggio di saluto che confermerà che la chiamata è avvenuta con successo. Per risparmiare tempo, cercate il codice dell'esempio Hello World nella directory <literal>/examples/remoting/helloworld</literal> di Seam." #. Tag: para -#: Remoting.xml:96 +#: Remoting.xml:87 #, no-c-format -msgid "" -"So what does the code of our script actually do? Let's break it down into " -"smaller pieces. To start with, you can see from the Javascript code listing " -"that we have implemented two methods - the first method is responsible for " -"prompting the user for their name and then making a remote request. Take a " -"look at the following line:" -msgstr "" +msgid "So what does the code of our script actually do? Let's break it down into smaller pieces. To start with, you can see from the Javascript code listing that we have implemented two methods - the first method is responsible for prompting the user for their name and then making a remote request. Take a look at the following line:" +msgstr "Quindi, cosa fa realmente il codice del nostro script? Dividiamolo in pezzi più piccoli. Tanto per iniziare, dal listato Javascript si vede che abbiamo implementato due metodi - il primo serve a chiedere all'utente il suo nome e a fare una richiesta remota. Guardate la seguente linea:" #. Tag: programlisting -#: Remoting.xml:101 +#: Remoting.xml:92 #, no-c-format -msgid "" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" -msgstr "" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" +msgid "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" +msgstr "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" #. Tag: para -#: Remoting.xml:103 +#: Remoting.xml:94 #, no-c-format -msgid "" -"The first section of this line, <literal>Seam.Component.getInstance" -"(\"helloAction\")</literal> returns a proxy, or \"stub\" for our " -"<literal>helloAction</literal> component. We can invoke the methods of our " -"component against this stub, which is exactly what happens with the " -"remainder of the line: <literal>sayHello(name, sayHelloCallback);</literal>." -msgstr "" +msgid "The first section of this line, <literal>Seam.Component.getInstance(\"helloAction\")</literal> returns a proxy, or \"stub\" for our <literal>helloAction</literal> component. We can invoke the methods of our component against this stub, which is exactly what happens with the remainder of the line: <literal>sayHello(name, sayHelloCallback);</literal>." +msgstr "La prima parte di questa linea, <literal>Seam.Component.getInstance(\"helloAction\")</literal> restituisce un proxy, o \"stub\", del componente <literal>helloAction</literal>. Possiamo chiamare i metodi di questo componente usando tale stub, che è ciò che accade nel resto della linea: <literal>sayHello(name, sayHelloCallback);</literal>." #. Tag: para -#: Remoting.xml:108 +#: Remoting.xml:99 #, no-c-format -msgid "" -"What this line of code in its completeness does, is invoke the " -"<literal>sayHello</literal> method of our component, passing in " -"<literal>name</literal> as a parameter. The second parameter, " -"<literal>sayHelloCallback</literal> isn't a parameter of our component's " -"<literal>sayHello</literal> method, instead it tells the Seam Remoting " -"framework that once it receives the response to our request, it should pass " -"it to the <literal>sayHelloCallback</literal> Javascript method. This " -"callback parameter is entirely optional, so feel free to leave it out if " -"you're calling a method with a <literal>void</literal> return type or if you " -"don't care about the result." -msgstr "" +msgid "What this line of code in its completeness does, is invoke the <literal>sayHello</literal> method of our component, passing in <literal>name</literal> as a parameter. The second parameter, <literal>sayHelloCallback</literal> isn't a parameter of our component's <literal>sayHello</literal> method, instead it tells the Seam Remoting framework that once it receives the response to our request, it should pass it to the <literal>sayHelloCallback</literal> Javascript method. This callback parameter is entirely optional, so feel free to leave it out if you're calling a method with a <literal>void</literal> return type or if you don't care about the result." +msgstr "Nel suo complesso questa linea di codice invoca il metodo <literal>sayHello</literal> del componente, passandogli <literal>name</literal> come parametro. Il secondo parametro, <literal>sayHelloCallback</literal> non è un parametro del metodo <literal>sayHello</literal> del componente, ma, invece, comunica al Remoting framework di Seam che, una volta ricevuta la risposta alla richiesta, deve passarla al metodo Javascript <literal>sayHelloCallback</literal>. Questo parametro di callback è completamente opzionale, quindi sentitevi liberi di non usarlo se chiamate un metodo che restituisce <literal>void</literal> o se non siete interessati al risultato." #. Tag: para -#: Remoting.xml:116 +#: Remoting.xml:107 #, no-c-format -msgid "" -"The <literal>sayHelloCallback</literal> method, once receiving the response " -"to our remote request then pops up an alert message displaying the result of " -"our method call." -msgstr "" +msgid "The <literal>sayHelloCallback</literal> method, once receiving the response to our remote request then pops up an alert message displaying the result of our method call." +msgstr "Il metodo <literal>sayHelloCallback</literal>, una volta ricevuta la risposta, mostra un messaggio di avviso con il risultato della chiamata." #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:113 #, no-c-format msgid "Seam.Component" msgstr "Seam.Component" #. Tag: para -#: Remoting.xml:124 +#: Remoting.xml:115 #, no-c-format -msgid "" -"The <literal>Seam.Component</literal> Javascript object provides a number of " -"client-side methods for working with your Seam components. The two main " -"methods, <literal>newInstance()</literal> and <literal>getInstance()</" -"literal> are documented in the following sections however their main " -"difference is that <literal>newInstance()</literal> will always create a new " -"instance of a component type, and <literal>getInstance()</literal> will " -"return a singleton instance." -msgstr "" +msgid "The <literal>Seam.Component</literal> Javascript object provides a number of client-side methods for working with your Seam components. The two main methods, <literal>newInstance()</literal> and <literal>getInstance()</literal> are documented in the following sections however their main difference is that <literal>newInstance()</literal> will always create a new instance of a component type, and <literal>getInstance()</literal> will return a singleton instance." +msgstr "L'oggetto Javascript <literal>Seam.Component</literal> fornisce un serie di metodi lato client per lavorare con i componenti Seam dell'applicazione. I due metodi principali, <literal>newInstance()</literal> e <literal>getInstance()</literal> sono documentati nelle sezioni successive, comunque, la loro differenza principale sta nel fatto che <literal>newInstance()</literal> crea sempre una nuova istanza di un tipo di componente, mentre <literal>getInstance()</literal> restituisce un'istanza singleton." #. Tag: title -#: Remoting.xml:131 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "Seam.Component.newInstance()" #. Tag: para -#: Remoting.xml:132 +#: Remoting.xml:123 #, no-c-format -msgid "" -"Use this method to create a new instance of an entity or Javabean component. " -"The object returned by this method will have the same getter/setter methods " -"as its server-side counterpart, or alternatively if you wish you can access " -"its fields directly. Take the following Seam entity component for example:" +msgid "Use this method to create a new instance of an entity or Javabean component. The object returned by this method will have the same getter/setter methods as its server-side counterpart, or alternatively if you wish you can access its fields directly. Take the following Seam entity component for example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:136 +#: Remoting.xml:127 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -535,25 +385,25 @@ "}" #. Tag: para -#: Remoting.xml:138 +#: Remoting.xml:129 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:140 +#: Remoting.xml:131 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "var customer = Seam.Component.newInstance(\"customer\");" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:133 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:144 +#: Remoting.xml:135 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -565,54 +415,43 @@ "customer.lastName = \"Smith\";" #. Tag: title -#: Remoting.xml:149 +#: Remoting.xml:140 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "Seam.Component.getInstance()" #. Tag: para -#: Remoting.xml:151 +#: Remoting.xml:142 #, no-c-format -msgid "" -"The <literal>getInstance()</literal> method is used to get a reference to a " -"Seam session bean component stub, which can then be used to remotely execute " -"methods against your component. This method returns a singleton for the " -"specified component, so calling it twice in a row with the same component " -"name will return the same instance of the component." +msgid "The <literal>getInstance()</literal> method is used to get a reference to a Seam session bean component stub, which can then be used to remotely execute methods against your component. This method returns a singleton for the specified component, so calling it twice in a row with the same component name will return the same instance of the component." msgstr "" #. Tag: para -#: Remoting.xml:156 +#: Remoting.xml:147 #, no-c-format -msgid "" -"To continue our example from before, if we have created a new " -"<literal>customer</literal> and we now wish to save it, we would pass it to " -"the <literal>saveCustomer()</literal> method of our <literal>customerAction</" -"literal> component:" +msgid "To continue our example from before, if we have created a new <literal>customer</literal> and we now wish to save it, we would pass it to the <literal>saveCustomer()</literal> method of our <literal>customerAction</literal> component:" msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:151 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" #. Tag: title -#: Remoting.xml:164 +#: Remoting.xml:155 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "Seam.Component.getComponentName()" #. Tag: para -#: Remoting.xml:166 +#: Remoting.xml:157 #, no-c-format -msgid "" -"Passing an object into this method will return its component name if it is a " -"component, or <literal>null</literal> if it is not." +msgid "Passing an object into this method will return its component name if it is a component, or <literal>null</literal> if it is not." msgstr "" #. Tag: programlisting -#: Remoting.xml:169 +#: Remoting.xml:160 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -626,81 +465,61 @@ " alert(\"Staff member\");" #. Tag: title -#: Remoting.xml:175 +#: Remoting.xml:166 #, no-c-format msgid "Seam.Remoting" msgstr "Seam.Remoting" #. Tag: para -#: Remoting.xml:177 +#: Remoting.xml:168 #, no-c-format -msgid "" -"Most of the client side functionality for Seam Remoting is contained within " -"the <literal>Seam.Remoting</literal> object. While you shouldn't need to " -"directly call most of its methods, there are a couple of important ones " -"worth mentioning." +msgid "Most of the client side functionality for Seam Remoting is contained within the <literal>Seam.Remoting</literal> object. While you shouldn't need to directly call most of its methods, there are a couple of important ones worth mentioning." msgstr "" #. Tag: title -#: Remoting.xml:182 +#: Remoting.xml:173 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "Seam.Remoting.createType()" #. Tag: para -#: Remoting.xml:184 +#: Remoting.xml:175 #, no-c-format -msgid "" -"If your application contains or uses Javabean classes that aren't Seam " -"components, you may need to create these types on the client side to pass as " -"parameters into your component method. Use the <literal>createType()</" -"literal> method to create an instance of your type. Pass in the fully " -"qualified Java class name as a parameter:" +msgid "If your application contains or uses Javabean classes that aren't Seam components, you may need to create these types on the client side to pass as parameters into your component method. Use the <literal>createType()</literal> method to create an instance of your type. Pass in the fully qualified Java class name as a parameter:" msgstr "" #. Tag: programlisting -#: Remoting.xml:189 +#: Remoting.xml:180 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" #. Tag: title -#: Remoting.xml:193 +#: Remoting.xml:184 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "Seam.Remoting.getTypeName()" #. Tag: para -#: Remoting.xml:195 +#: Remoting.xml:186 #, no-c-format -msgid "" -"This method is the equivalent of <literal>Seam.Component.getComponentName()</" -"literal> but for non-component types. It will return the name of the type " -"for an object instance, or <literal>null</literal> if the type is not known. " -"The name is the fully qualified name of the type's Java class." +msgid "This method is the equivalent of <literal>Seam.Component.getComponentName()</literal> but for non-component types. It will return the name of the type for an object instance, or <literal>null</literal> if the type is not known. The name is the fully qualified name of the type's Java class." msgstr "" #. Tag: title -#: Remoting.xml:203 +#: Remoting.xml:194 #, no-c-format msgid "Evaluating EL Expressions" msgstr "Valutazione delle espressioni EL" #. Tag: para -#: Remoting.xml:205 +#: Remoting.xml:196 #, no-c-format -msgid "" -"Seam Remoting also supports the evaluation of EL expressions, which provides " -"another convenient method for retrieving data from the server. Using the " -"<literal>Seam.Remoting.eval()</literal> function, an EL expression can be " -"remotely evaluated on the server and the resulting value returned to a " -"client-side callback method. This function accepts two parameters, the first " -"being the EL expression to evaluate, and the second being the callback " -"method to invoke with the value of the expression. Here's an example:" +msgid "Seam Remoting also supports the evaluation of EL expressions, which provides another convenient method for retrieving data from the server. Using the <literal>Seam.Remoting.eval()</literal> function, an EL expression can be remotely evaluated on the server and the resulting value returned to a client-side callback method. This function accepts two parameters, the first being the EL expression to evaluate, and the second being the callback method to invoke with the value of the expression. Here's an example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:213 +#: Remoting.xml:204 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -722,313 +541,215 @@ " ]]>" #. Tag: para -#: Remoting.xml:215 +#: Remoting.xml:206 #, no-c-format -msgid "" -"In this example, the expression <literal>#{customers}</literal> is evaluated " -"by Seam, and the value of the expression (in this case a list of Customer " -"objects) is returned to the <literal>customersCallback()</literal> method. " -"It is important to remember that the objects returned this way must have " -"their types imported (via <literal>s:remote</literal>) to be able to work " -"with them in Javascript. So to work with a list of <literal>customer</" -"literal> objects, it is required to import the <literal>customer</literal> " -"type:" +msgid "In this example, the expression <literal>#{customers}</literal> is evaluated by Seam, and the value of the expression (in this case a list of Customer objects) is returned to the <literal>customersCallback()</literal> method. It is important to remember that the objects returned this way must have their types imported (via <literal>s:remote</literal>) to be able to work with them in Javascript. So to work with a list of <literal>customer</literal> objects, it is required to import the <literal>customer</literal> type:" msgstr "" #. Tag: programlisting -#: Remoting.xml:223 +#: Remoting.xml:214 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customer\"/>]]>" #. Tag: title -#: Remoting.xml:227 +#: Remoting.xml:218 #, no-c-format msgid "Client Interfaces" msgstr "Interfacce client" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:220 #, no-c-format -msgid "" -"In the configuration section above, the interface, or \"stub\" for our " -"component is imported into our page either via <literal>seam/resource/" -"remoting/interface.js</literal>: or using the <literal>s:remote</literal> " -"tag:" +msgid "In the configuration section above, the interface, or \"stub\" for our component is imported into our page either via <literal>seam/resource/remoting/interface.js</literal>: or using the <literal>s:remote</literal> tag:" msgstr "" #. Tag: programlisting -#: Remoting.xml:234 +#: Remoting.xml:225 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></" -"script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></" -"script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" #. Tag: programlisting -#: Remoting.xml:236 +#: Remoting.xml:227 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customerAction\"/>]]>" #. Tag: para -#: Remoting.xml:238 +#: Remoting.xml:229 #, no-c-format -msgid "" -"By including this script in our page, the interface definitions for our " -"component, plus any other components or types that are required to execute " -"the methods of our component are generated and made available for the " -"remoting framework to use." +msgid "By including this script in our page, the interface definitions for our component, plus any other components or types that are required to execute the methods of our component are generated and made available for the remoting framework to use." msgstr "" #. Tag: para -#: Remoting.xml:242 +#: Remoting.xml:233 #, no-c-format -msgid "" -"There are two types of client stub that can be generated, \"executable\" " -"stubs and \"type\" stubs. Executable stubs are behavioural, and are used to " -"execute methods against your session bean components, while type stubs " -"contain state and represent the types that can be passed in as parameters or " -"returned as a result." +msgid "There are two types of client stub that can be generated, \"executable\" stubs and \"type\" stubs. Executable stubs are behavioural, and are used to execute methods against your session bean components, while type stubs contain state and represent the types that can be passed in as parameters or returned as a result." msgstr "" #. Tag: para -#: Remoting.xml:246 +#: Remoting.xml:237 #, no-c-format -msgid "" -"The type of client stub that is generated depends on the type of your Seam " -"component. If the component is a session bean, then an executable stub will " -"be generated, otherwise if it's an entity or JavaBean, then a type stub will " -"be generated. There is one exception to this rule; if your component is a " -"JavaBean (ie it is not a session bean nor an entity bean) and any of its " -"methods are annotated with @WebRemote, then an executable stub will be " -"generated for it instead of a type stub. This allows you to use remoting to " -"call methods of your JavaBean components in a non-EJB environment where you " -"don't have access to session beans." +msgid "The type of client stub that is generated depends on the type of your Seam component. If the component is a session bean, then an executable stub will be generated, otherwise if it's an entity or JavaBean, then a type stub will be generated. There is one exception to this rule; if your component is a JavaBean (ie it is not a session bean nor an entity bean) and any of its methods are annotated with @WebRemote, then an executable stub will be generated for it instead of a type stub. This allows you to use remoting to call methods of your JavaBean components in a non-EJB environment where you don't have access to session beans." msgstr "" #. Tag: title -#: Remoting.xml:256 +#: Remoting.xml:247 #, no-c-format msgid "The Context" msgstr "Il contesto" #. Tag: para -#: Remoting.xml:258 +#: Remoting.xml:249 #, no-c-format -msgid "" -"The Seam Remoting Context contains additional information which is sent and " -"received as part of a remoting request/response cycle. At this stage it only " -"contains the conversation ID but may be expanded in the future." +msgid "The Seam Remoting Context contains additional information which is sent and received as part of a remoting request/response cycle. At this stage it only contains the conversation ID but may be expanded in the future." msgstr "" #. Tag: title -#: Remoting.xml:262 +#: Remoting.xml:253 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "Impostazione e lettura dell'ID di conversazione" #. Tag: para -#: Remoting.xml:265 +#: Remoting.xml:256 #, no-c-format -msgid "" -"If you intend on using remote calls within the scope of a conversation then " -"you need to be able to read or set the conversation ID in the Seam Remoting " -"Context. To read the conversation ID after making a remote request call " -"<literal>Seam.Remoting.getContext().getConversationId()</literal>. To set " -"the conversation ID before making a request, call <literal>Seam.Remoting." -"getContext().setConversationId()</literal>." +msgid "If you intend on using remote calls within the scope of a conversation then you need to be able to read or set the conversation ID in the Seam Remoting Context. To read the conversation ID after making a remote request call <literal>Seam.Remoting.getContext().getConversationId()</literal>. To set the conversation ID before making a request, call <literal>Seam.Remoting.getContext().setConversationId()</literal>." msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:261 #, no-c-format -msgid "" -"If the conversation ID hasn't been explicitly set with <literal>Seam." -"Remoting.getContext().setConversationId()</literal>, then it will be " -"automatically assigned the first valid conversation ID that is returned by " -"any remoting call. If you are working with multiple conversations within " -"your page, then you may need to explicitly set the conversation ID before " -"each call. If you are working with just a single conversation, then you " -"don't need to do anything special." +msgid "If the conversation ID hasn't been explicitly set with <literal>Seam.Remoting.getContext().setConversationId()</literal>, then it will be automatically assigned the first valid conversation ID that is returned by any remoting call. If you are working with multiple conversations within your page, then you may need to explicitly set the conversation ID before each call. If you are working with just a single conversation, then you don't need to do anything special." msgstr "" #. Tag: title -#: Remoting.xml:277 +#: Remoting.xml:268 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:279 +#: Remoting.xml:270 #, no-c-format -msgid "" -"In some circumstances it may be required to make a remote call within the " -"scope of the current view's conversation. To do this, you must explicitly " -"set the conversation ID to that of the view before making the remote call. " -"This small snippet of JavaScript will set the conversation ID that is used " -"for remoting calls to the current view's conversation ID:" +msgid "In some circumstances it may be required to make a remote call within the scope of the current view's conversation. To do this, you must explicitly set the conversation ID to that of the view before making the remote call. This small snippet of JavaScript will set the conversation ID that is used for remoting calls to the current view's conversation ID:" msgstr "" #. Tag: programlisting -#: Remoting.xml:284 +#: Remoting.xml:275 #, no-c-format -msgid "" -"<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." -"id} );]]>" -msgstr "" -"<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." -"id} );]]>" +msgid "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation.id} );]]>" +msgstr "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation.id} );]]>" #. Tag: title -#: Remoting.xml:289 +#: Remoting.xml:280 #, no-c-format msgid "Batch Requests" msgstr "Richieste batch" #. Tag: para -#: Remoting.xml:291 +#: Remoting.xml:282 #, no-c-format -msgid "" -"Seam Remoting allows multiple component calls to be executed within a single " -"request. It is recommended that this feature is used wherever it is " -"appropriate to reduce network traffic." +msgid "Seam Remoting allows multiple component calls to be executed within a single request. It is recommended that this feature is used wherever it is appropriate to reduce network traffic." msgstr "" #. Tag: para -#: Remoting.xml:294 +#: Remoting.xml:285 #, no-c-format -msgid "" -"The method <literal>Seam.Remoting.startBatch()</literal> will start a new " -"batch, and any component calls executed after starting a batch are queued, " -"rather than being sent immediately. When all the desired component calls " -"have been added to the batch, the <literal>Seam.Remoting.executeBatch()</" -"literal> method will send a single request containing all of the queued " -"calls to the server, where they will be executed in order. After the calls " -"have been executed, a single response containining all return values will be " -"returned to the client and the callback functions (if provided) triggered in " -"the same order as execution." +msgid "The method <literal>Seam.Remoting.startBatch()</literal> will start a new batch, and any component calls executed after starting a batch are queued, rather than being sent immediately. When all the desired component calls have been added to the batch, the <literal>Seam.Remoting.executeBatch()</literal> method will send a single request containing all of the queued calls to the server, where they will be executed in order. After the calls have been executed, a single response containining all return values will be returned to the client and the callback functions (if provided) triggered in the same order as execution." msgstr "" #. Tag: para -#: Remoting.xml:301 +#: Remoting.xml:292 #, no-c-format -msgid "" -"If you start a new batch via the <literal>startBatch()</literal> method but " -"then decide you don't want to send it, the <literal>Seam.Remoting.cancelBatch" -"()</literal> method will discard any calls that were queued and exit the " -"batch mode." +msgid "If you start a new batch via the <literal>startBatch()</literal> method but then decide you don't want to send it, the <literal>Seam.Remoting.cancelBatch()</literal> method will discard any calls that were queued and exit the batch mode." msgstr "" #. Tag: para -#: Remoting.xml:305 +#: Remoting.xml:296 #, no-c-format -msgid "" -"To see an example of a batch being used, take a look at <literal>/examples/" -"remoting/chatroom</literal>." +msgid "To see an example of a batch being used, take a look at <literal>/examples/remoting/chatroom</literal>." msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:301 #, no-c-format msgid "Working with Data types" msgstr "Lavorare con i tipi di dati" #. Tag: title -#: Remoting.xml:313 +#: Remoting.xml:304 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:315 +#: Remoting.xml:306 #, no-c-format -msgid "" -"This section describes the support for basic data types. On the server side " -"these values are generally compatible with either their primitive type or " -"their corresponding wrapper class." +msgid "This section describes the support for basic data types. On the server side these values are generally compatible with either their primitive type or their corresponding wrapper class." msgstr "" #. Tag: title -#: Remoting.xml:319 +#: Remoting.xml:310 #, no-c-format msgid "String" msgstr "String" #. Tag: para -#: Remoting.xml:321 +#: Remoting.xml:312 #, no-c-format -msgid "" -"Simply use Javascript String objects when setting String parameter values." +msgid "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:325 +#: Remoting.xml:316 #, no-c-format msgid "Number" msgstr "Number" #. Tag: para -#: Remoting.xml:327 +#: Remoting.xml:318 #, no-c-format -msgid "" -"There is support for all number types supported by Java. On the client side, " -"number values are always serialized as their String representation and then " -"on the server side they are converted to the correct destination type. " -"Conversion into either a primitive or wrapper type is supported for " -"<literal>Byte</literal>, <literal>Double</literal>, <literal>Float</" -"literal>, <literal>Integer</literal>, <literal>Long</literal> and " -"<literal>Short</literal> types." +msgid "There is support for all number types supported by Java. On the client side, number values are always serialized as their String representation and then on the server side they are converted to the correct destination type. Conversion into either a primitive or wrapper type is supported for <literal>Byte</literal>, <literal>Double</literal>, <literal>Float</literal>, <literal>Integer</literal>, <literal>Long</literal> and <literal>Short</literal> types." msgstr "" #. Tag: title -#: Remoting.xml:335 +#: Remoting.xml:326 #, no-c-format msgid "Boolean" msgstr "Boolean" #. Tag: para -#: Remoting.xml:337 +#: Remoting.xml:328 #, no-c-format -msgid "" -"Booleans are represented client side by Javascript Boolean values, and " -"server side by a Java boolean." +msgid "Booleans are represented client side by Javascript Boolean values, and server side by a Java boolean." msgstr "" #. Tag: title -#: Remoting.xml:343 +#: Remoting.xml:334 #, no-c-format msgid "JavaBeans" msgstr "JavaBeans" #. Tag: para -#: Remoting.xml:345 +#: Remoting.xml:336 #, no-c-format -msgid "" -"In general these will be either Seam entity or JavaBean components, or some " -"other non-component class. Use the appropriate method (either <literal>Seam." -"Component.newInstance()</literal> for Seam components or <literal>Seam." -"Remoting.createType()</literal> for everything else) to create a new " -"instance of the object." +msgid "In general these will be either Seam entity or JavaBean components, or some other non-component class. Use the appropriate method (either <literal>Seam.Component.newInstance()</literal> for Seam components or <literal>Seam.Remoting.createType()</literal> for everything else) to create a new instance of the object." msgstr "" #. Tag: para -#: Remoting.xml:349 +#: Remoting.xml:340 #, no-c-format -msgid "" -"It is important to note that only objects that are created by either of " -"these two methods should be used as parameter values, where the parameter is " -"not one of the other valid types mentioned anywhere else in this section. In " -"some situations you may have a component method where the exact parameter " -"type cannot be determined, such as:" +msgid "It is important to note that only objects that are created by either of these two methods should be used as parameter values, where the parameter is not one of the other valid types mentioned anywhere else in this section. In some situations you may have a component method where the exact parameter type cannot be determined, such as:" msgstr "" #. Tag: programlisting -#: Remoting.xml:354 +#: Remoting.xml:345 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -1046,70 +767,49 @@ "}" #. Tag: para -#: Remoting.xml:356 +#: Remoting.xml:347 #, no-c-format -msgid "" -"In this case you might want to pass in an instance of your " -"<literal>myWidget</literal> component, however the interface for " -"<literal>myAction</literal> won't include <literal>myWidget</literal> as it " -"is not directly referenced by any of its methods. To get around this, " -"<literal>MyWidget</literal> needs to be explicitly imported:" +msgid "In this case you might want to pass in an instance of your <literal>myWidget</literal> component, however the interface for <literal>myAction</literal> won't include <literal>myWidget</literal> as it is not directly referenced by any of its methods. To get around this, <literal>MyWidget</literal> needs to be explicitly imported:" msgstr "" #. Tag: programlisting -#: Remoting.xml:361 +#: Remoting.xml:352 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:354 #, no-c-format -msgid "" -"This will then allow a <literal>myWidget</literal> object to be created with " -"<literal>Seam.Component.newInstance(\"myWidget\")</literal>, which can then " -"be passed to <literal>myAction.doSomethingWithObject()</literal>." +msgid "This will then allow a <literal>myWidget</literal> object to be created with <literal>Seam.Component.newInstance(\"myWidget\")</literal>, which can then be passed to <literal>myAction.doSomethingWithObject()</literal>." msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:361 #, no-c-format msgid "Dates and Times" msgstr "Date e orari" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:363 #, no-c-format -msgid "" -"Date values are serialized into a String representation that is accurate to " -"the millisecond. On the client side, use a Javascript Date object to work " -"with date values. On the server side, use any <literal>java.util.Date</" -"literal> (or descendent, such as <literal>java.sql.Date</literal> or " -"<literal>java.sql.Timestamp</literal> class." -msgstr "" -"I valori delle date sono serializzati in una rappresentazione di Strina che " -"è accurata al millisecondo. Lato client, si usi un oggetto Date Javascript " -"per lavorare con i valori delle date. Late server, si usi <literal>java.util." -"Date</literal> (o discendenti, come le classi <literal>java.sql.Date</" -"literal> o <literal>java.sql.Timestamp</literal>)." +msgid "Date values are serialized into a String representation that is accurate to the millisecond. On the client side, use a Javascript Date object to work with date values. On the server side, use any <literal>java.util.Date</literal> (or descendent, such as <literal>java.sql.Date</literal> or <literal>java.sql.Timestamp</literal> class." +msgstr "I valori delle date sono serializzati in una rappresentazione di Strina che è accurata al millisecondo. Lato client, si usi un oggetto Date Javascript per lavorare con i valori delle date. Late server, si usi <literal>java.util.Date</literal> (o discendenti, come le classi <literal>java.sql.Date</literal> o <literal>java.sql.Timestamp</literal>)." #. Tag: title -#: Remoting.xml:379 +#: Remoting.xml:370 #, no-c-format msgid "Enums" msgstr "Enums" #. Tag: para -#: Remoting.xml:381 +#: Remoting.xml:372 #, no-c-format -msgid "" -"On the client side, enums are treated the same as Strings. When setting the " -"value for an enum parameter, simply use the String representation of the " -"enum. Take the following component as an example:" +msgid "On the client side, enums are treated the same as Strings. When setting the value for an enum parameter, simply use the String representation of the enum. Take the following component as an example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:384 +#: Remoting.xml:375 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -1131,255 +831,191 @@ "}" #. Tag: para -#: Remoting.xml:386 +#: Remoting.xml:377 #, no-c-format -msgid "" -"To call the <literal>paint()</literal> method with the color <literal>red</" -"literal>, pass the parameter value as a String literal:" +msgid "To call the <literal>paint()</literal> method with the color <literal>red</literal>, pass the parameter value as a String literal:" msgstr "" #. Tag: programlisting -#: Remoting.xml:389 +#: Remoting.xml:380 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" #. Tag: para -#: Remoting.xml:391 +#: Remoting.xml:382 #, no-c-format -msgid "" -"The inverse is also true - that is, if a component method returns an enum " -"parameter (or contains an enum field anywhere in the returned object graph) " -"then on the client-side it will be represented as a String." +msgid "The inverse is also true - that is, if a component method returns an enum parameter (or contains an enum field anywhere in the returned object graph) then on the client-side it will be represented as a String." msgstr "" #. Tag: title -#: Remoting.xml:396 +#: Remoting.xml:387 #, no-c-format msgid "Collections" msgstr "Collections" #. Tag: title -#: Remoting.xml:399 +#: Remoting.xml:390 #, no-c-format msgid "Bags" msgstr "Bags" #. Tag: para -#: Remoting.xml:401 +#: Remoting.xml:392 #, no-c-format -msgid "" -"Bags cover all collection types including arrays, collections, lists, sets, " -"(but excluding Maps - see the next section for those), and are implemented " -"client-side as a Javascript array. When calling a component method that " -"accepts one of these types as a parameter, your parameter should be a " -"Javascript array. If a component method returns one of these types, then the " -"return value will also be a Javascript array. The remoting framework is " -"clever enough on the server side to convert the bag to an appropriate type " -"for the component method call." +msgid "Bags cover all collection types including arrays, collections, lists, sets, (but excluding Maps - see the next section for those), and are implemented client-side as a Javascript array. When calling a component method that accepts one of these types as a parameter, your parameter should be a Javascript array. If a component method returns one of these types, then the return value will also be a Javascript array. The remoting framework is clever enough on the server side to convert the bag to an appropriate type for the component method call." msgstr "" #. Tag: title -#: Remoting.xml:410 +#: Remoting.xml:401 #, no-c-format msgid "Maps" msgstr "Maps" #. Tag: para -#: Remoting.xml:412 +#: Remoting.xml:403 #, no-c-format -msgid "" -"As there is no native support for Maps within Javascript, a simple Map " -"implementation is provided with the Seam Remoting framework. To create a Map " -"which can be used as a parameter to a remote call, create a new " -"<literal>Seam.Remoting.Map</literal> object:" +msgid "As there is no native support for Maps within Javascript, a simple Map implementation is provided with the Seam Remoting framework. To create a Map which can be used as a parameter to a remote call, create a new <literal>Seam.Remoting.Map</literal> object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:416 +#: Remoting.xml:407 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "var map = new Seam.Remoting.Map();" #. Tag: para -#: Remoting.xml:418 +#: Remoting.xml:409 #, no-c-format -msgid "" -"This Javascript implementation provides basic methods for working with Maps: " -"<literal>size()</literal>, <literal>isEmpty()</literal>, <literal>keySet()</" -"literal>, <literal>values()</literal>, <literal>get(key)</literal>, " -"<literal>put(key, value)</literal>, <literal>remove(key)</literal> and " -"<literal>contains(key)</literal>. Each of these methods are equivalent to " -"their Java counterpart. Where the method returns a collection, such as " -"<literal>keySet()</literal> and <literal>values()</literal>, a Javascript " -"Array object will be returned that contains the key or value objects " -"(respectively)." +msgid "This Javascript implementation provides basic methods for working with Maps: <literal>size()</literal>, <literal>isEmpty()</literal>, <literal>keySet()</literal>, <literal>values()</literal>, <literal>get(key)</literal>, <literal>put(key, value)</literal>, <literal>remove(key)</literal> and <literal>contains(key)</literal>. Each of these methods are equivalent to their Java counterpart. Where the method returns a collection, such as <literal>keySet()</literal> and <literal>values()</literal>, a Javascript Array object will be returned that contains the key or value objects (respectively)." msgstr "" #. Tag: title -#: Remoting.xml:429 +#: Remoting.xml:420 #, no-c-format msgid "Debugging" msgstr "Debugging" #. Tag: para -#: Remoting.xml:431 +#: Remoting.xml:422 #, no-c-format -msgid "" -"To aid in tracking down bugs, it is possible to enable a debug mode which " -"will display the contents of all the packets send back and forth between the " -"client and server in a popup window. To enable debug mode, either execute " -"the <literal>setDebug()</literal> method in Javascript:" +msgid "To aid in tracking down bugs, it is possible to enable a debug mode which will display the contents of all the packets send back and forth between the client and server in a popup window. To enable debug mode, either execute the <literal>setDebug()</literal> method in Javascript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:435 +#: Remoting.xml:426 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "Seam.Remoting.setDebug(true);" #. Tag: para -#: Remoting.xml:437 +#: Remoting.xml:428 #, no-c-format msgid "Or configure it via components.xml:" msgstr "O lo si configuri via components.xml:" #. Tag: programlisting -#: Remoting.xml:439 +#: Remoting.xml:430 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" #. Tag: para -#: Remoting.xml:441 +#: Remoting.xml:432 #, no-c-format -msgid "" -"To turn off debugging, call <literal>setDebug(false)</literal>. If you want " -"to write your own messages to the debug log, call <literal>Seam.Remoting.log" -"(message)</literal>." +msgid "To turn off debugging, call <literal>setDebug(false)</literal>. If you want to write your own messages to the debug log, call <literal>Seam.Remoting.log(message)</literal>." msgstr "" #. Tag: title -#: Remoting.xml:446 +#: Remoting.xml:437 #, no-c-format msgid "Handling Exceptions" msgstr "Gestione delle eccezioni" #. Tag: para -#: Remoting.xml:448 +#: Remoting.xml:439 #, no-c-format -msgid "" -"When invoking a remote component method, it is possible to specify an " -"exception handler which will process the response in the event of an " -"exception during component invocation. To specify an exception handler " -"function, include a reference to it after the callback parameter in your " -"JavaScript:" +msgid "When invoking a remote component method, it is possible to specify an exception handler which will process the response in the event of an exception during component invocation. To specify an exception handler function, include a reference to it after the callback parameter in your JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:454 +#: Remoting.xml:445 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" -"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex." -"getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, " -"exceptionHandler);]]>" +"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, exceptionHandler);]]>" msgstr "" "<![CDATA[var callback = function(result) { alert(result); };\n" -"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex." -"getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, " -"exceptionHandler);]]>" +"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, exceptionHandler);]]>" #. Tag: para -#: Remoting.xml:456 +#: Remoting.xml:447 #, no-c-format -msgid "" -"If you do not have a callback handler defined, you must specify " -"<literal>null</literal> in its place:" +msgid "If you do not have a callback handler defined, you must specify <literal>null</literal> in its place:" msgstr "" #. Tag: programlisting -#: Remoting.xml:460 +#: Remoting.xml:451 #, no-c-format msgid "" -"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " -"occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, " -"exceptionHandler);]]>" +"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, exceptionHandler);]]>" msgstr "" -"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " -"occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, " -"exceptionHandler);]]>" +"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, exceptionHandler);]]>" #. Tag: para -#: Remoting.xml:462 +#: Remoting.xml:453 #, no-c-format -msgid "" -"The exception object that is passed to the exception handler exposes one " -"method, <literal>getMessage()</literal> that returns the exception message " -"which is produced by the exception thrown by the <literal>@WebRemote</" -"literal> method." +msgid "The exception object that is passed to the exception handler exposes one method, <literal>getMessage()</literal> that returns the exception message which is produced by the exception thrown by the <literal>@WebRemote</literal> method." msgstr "" #. Tag: title -#: Remoting.xml:471 +#: Remoting.xml:462 #, no-c-format msgid "The Loading Message" msgstr "Il messaggio di caricamento" #. Tag: para -#: Remoting.xml:473 +#: Remoting.xml:464 #, no-c-format -msgid "" -"The default loading message that appears in the top right corner of the " -"screen can be modified, its rendering customised or even turned off " -"completely." +msgid "The default loading message that appears in the top right corner of the screen can be modified, its rendering customised or even turned off completely." msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:468 #, no-c-format msgid "Changing the message" msgstr "Cambiare il messaggio" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:470 #, no-c-format -msgid "" -"To change the message from the default \"Please Wait...\" to something " -"different, set the value of <literal>Seam.Remoting.loadingMessage</literal>:" -msgstr "" -"Per cambiare il messaggio dal default \"Attendere prego...\" a qualcosa di " -"differente, si imposti il valore di <literal>Seam.Remoting.loadingMessage</" -"literal>:" +msgid "To change the message from the default \"Please Wait...\" to something different, set the value of <literal>Seam.Remoting.loadingMessage</literal>:" +msgstr "Per cambiare il messaggio dal default \"Attendere prego...\" a qualcosa di differente, si imposti il valore di <literal>Seam.Remoting.loadingMessage</literal>:" #. Tag: programlisting -#: Remoting.xml:482 +#: Remoting.xml:473 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "Seam.Remoting.loadingMessage = \"Loading...\";" #. Tag: title -#: Remoting.xml:486 +#: Remoting.xml:477 #, no-c-format msgid "Hiding the loading message" msgstr "Nascondere il messaggio di caricamento" #. Tag: para -#: Remoting.xml:488 +#: Remoting.xml:479 #, no-c-format -msgid "" -"To completely suppress the display of the loading message, override the " -"implementation of <literal>displayLoadingMessage()</literal> and " -"<literal>hideLoadingMessage()</literal> with functions that instead do " -"nothing:" +msgid "To completely suppress the display of the loading message, override the implementation of <literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()</literal> with functions that instead do nothing:" msgstr "" #. Tag: programlisting -#: Remoting.xml:492 +#: Remoting.xml:483 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1391,23 +1027,19 @@ "Seam.Remoting.hideLoadingMessage = function() {};" #. Tag: title -#: Remoting.xml:496 +#: Remoting.xml:487 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:498 +#: Remoting.xml:489 #, no-c-format -msgid "" -"It is also possible to override the loading indicator to display an animated " -"icon, or anything else that you want. To do this override the " -"<literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()" -"</literal> messages with your own implementation:" +msgid "It is also possible to override the loading indicator to display an animated icon, or anything else that you want. To do this override the <literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()</literal> messages with your own implementation:" msgstr "" #. Tag: programlisting -#: Remoting.xml:502 +#: Remoting.xml:493 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1427,49 +1059,31 @@ " };" #. Tag: title -#: Remoting.xml:507 +#: Remoting.xml:498 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:509 +#: Remoting.xml:500 #, no-c-format -msgid "" -"When a remote method is executed, the result is serialized into an XML " -"response that is returned to the client. This response is then unmarshaled " -"by the client into a Javascript object. For complex types (i.e. Javabeans) " -"that include references to other objects, all of these referenced objects " -"are also serialized as part of the response. These objects may reference " -"other objects, which may reference other objects, and so forth. If left " -"unchecked, this object \"graph\" could potentially be enormous, depending on " -"what relationships exist between your objects. And as a side issue (besides " -"the potential verbosity of the response), you might also wish to prevent " -"sensitive information from being exposed to the client." +msgid "When a remote method is executed, the result is serialized into an XML response that is returned to the client. This response is then unmarshaled by the client into a Javascript object. For complex types (i.e. Javabeans) that include references to other objects, all of these referenced objects are also serialized as part of the response. These objects may reference other objects, which may reference other objects, and so forth. If left unchecked, this object \"graph\" could potentially be enormous, depending on what relationships exist between your objects. And as a side issue (besides the potential verbosity of the response), you might also wish to prevent sensitive information from being exposed to the client." msgstr "" #. Tag: para -#: Remoting.xml:517 +#: Remoting.xml:508 #, no-c-format -msgid "" -"Seam Remoting provides a simple means to \"constrain\" the object graph, by " -"specifying the <literal>exclude</literal> field of the remote method's " -"<literal>@WebRemote</literal> annotation. This field accepts a String array " -"containing one or more paths specified using dot notation. When invoking a " -"remote method, the objects in the result's object graph that match these " -"paths are excluded from the serialized result packet." +msgid "Seam Remoting provides a simple means to \"constrain\" the object graph, by specifying the <literal>exclude</literal> field of the remote method's <literal>@WebRemote</literal> annotation. This field accepts a String array containing one or more paths specified using dot notation. When invoking a remote method, the objects in the result's object graph that match these paths are excluded from the serialized result packet." msgstr "" #. Tag: para -#: Remoting.xml:522 +#: Remoting.xml:513 #, no-c-format -msgid "" -"For all our examples, we'll use the following <literal>Widget</literal> " -"class:" +msgid "For all our examples, we'll use the following <literal>Widget</literal> class:" msgstr "" #. Tag: programlisting -#: Remoting.xml:524 +#: Remoting.xml:515 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1497,22 +1111,19 @@ "}" #. Tag: title -#: Remoting.xml:527 +#: Remoting.xml:518 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:529 +#: Remoting.xml:520 #, no-c-format -msgid "" -"If your remote method returns an instance of <literal>Widget</literal>, but " -"you don't want to expose the <literal>secret</literal> field because it " -"contains sensitive information, you would constrain it like this:" +msgid "If your remote method returns an instance of <literal>Widget</literal>, but you don't want to expose the <literal>secret</literal> field because it contains sensitive information, you would constrain it like this:" msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:523 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1522,21 +1133,13 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:534 +#: Remoting.xml:525 #, no-c-format -msgid "" -"The value \"secret\" refers to the <literal>secret</literal> field of the " -"returned object. Now, suppose that we don't care about exposing this " -"particular field to the client. Instead, notice that the <literal>Widget</" -"literal> value that is returned has a field <literal>child</literal> that is " -"also a <literal>Widget</literal>. What if we want to hide the " -"<literal>child</literal>'s <literal>secret</literal> value instead? We can " -"do this by using dot notation to specify this field's path within the " -"result's object graph:" +msgid "The value \"secret\" refers to the <literal>secret</literal> field of the returned object. Now, suppose that we don't care about exposing this particular field to the client. Instead, notice that the <literal>Widget</literal> value that is returned has a field <literal>child</literal> that is also a <literal>Widget</literal>. What if we want to hide the <literal>child</literal>'s <literal>secret</literal> value instead? We can do this by using dot notation to specify this field's path within the result's object graph:" msgstr "" #. Tag: programlisting -#: Remoting.xml:541 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1546,27 +1149,19 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:546 +#: Remoting.xml:537 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:539 #, no-c-format -msgid "" -"The other place that objects can exist within an object graph are within a " -"<literal>Map</literal> or some kind of collection (<literal>List</literal>, " -"<literal>Set</literal>, <literal>Array</literal>, etc). Collections are " -"easy, and are treated like any other field. For example, if our " -"<literal>Widget</literal> contained a list of other <literal>Widget</" -"literal>s in its <literal>widgetList</literal> field, to constrain the " -"<literal>secret</literal> field of the <literal>Widget</literal>s in this " -"list the annotation would look like this:" +msgid "The other place that objects can exist within an object graph are within a <literal>Map</literal> or some kind of collection (<literal>List</literal>, <literal>Set</literal>, <literal>Array</literal>, etc). Collections are easy, and are treated like any other field. For example, if our <literal>Widget</literal> contained a list of other <literal>Widget</literal>s in its <literal>widgetList</literal> field, to constrain the <literal>secret</literal> field of the <literal>Widget</literal>s in this list the annotation would look like this:" msgstr "" #. Tag: programlisting -#: Remoting.xml:555 +#: Remoting.xml:546 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1576,20 +1171,13 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:557 +#: Remoting.xml:548 #, no-c-format -msgid "" -"To constrain a <literal>Map</literal>'s key or value, the notation is " -"slightly different. Appending <literal>[key]</literal> after the " -"<literal>Map</literal>'s field name will constrain the <literal>Map</" -"literal>'s key object values, while <literal>[value]</literal> will " -"constrain the value object values. The following example demonstrates how " -"the values of the <literal>widgetMap</literal> field have their " -"<literal>secret</literal> field constrained:" +msgid "To constrain a <literal>Map</literal>'s key or value, the notation is slightly different. Appending <literal>[key]</literal> after the <literal>Map</literal>'s field name will constrain the <literal>Map</literal>'s key object values, while <literal>[value]</literal> will constrain the value object values. The following example demonstrates how the values of the <literal>widgetMap</literal> field have their <literal>secret</literal> field constrained:" msgstr "" #. Tag: programlisting -#: Remoting.xml:563 +#: Remoting.xml:554 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1599,24 +1187,19 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:567 +#: Remoting.xml:558 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:569 +#: Remoting.xml:560 #, no-c-format -msgid "" -"There is one last notation that can be used to constrain the fields of a " -"type of object no matter where in the result's object graph it appears. This " -"notation uses either the name of the component (if the object is a Seam " -"component) or the fully qualified class name (only if the object is not a " -"Seam component) and is expressed using square brackets:" +msgid "There is one last notation that can be used to constrain the fields of a type of object no matter where in the result's object graph it appears. This notation uses either the name of the component (if the object is a Seam component) or the fully qualified class name (only if the object is not a Seam component) and is expressed using square brackets:" msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:565 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1626,21 +1209,19 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:579 +#: Remoting.xml:570 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:581 +#: Remoting.xml:572 #, no-c-format -msgid "" -"Constraints can also be combined, to filter objects from multiple paths " -"within the object graph:" +msgid "Constraints can also be combined, to filter objects from multiple paths within the object graph:" msgstr "" #. Tag: programlisting -#: Remoting.xml:583 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1650,23 +1231,19 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:589 +#: Remoting.xml:580 #, no-c-format msgid "Transactional Requests" msgstr "Richieste transazionali" #. Tag: para -#: Remoting.xml:591 +#: Remoting.xml:582 #, no-c-format -msgid "" -"By default there is no active transaction during a remoting request, so if " -"you wish to perform database updates during a remoting request, you need to " -"annotate the <literal>@WebRemote</literal> method with " -"<literal>@Transactional</literal>, like so:" +msgid "By default there is no active transaction during a remoting request, so if you wish to perform database updates during a remoting request, you need to annotate the <literal>@WebRemote</literal> method with <literal>@Transactional</literal>, like so:" msgstr "" #. Tag: programlisting -#: Remoting.xml:597 +#: Remoting.xml:588 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1676,53 +1253,44 @@ msgstr "" #. Tag: title -#: Remoting.xml:601 +#: Remoting.xml:592 #, no-c-format msgid "JMS Messaging" msgstr "Messaggistica JMS" #. Tag: para -#: Remoting.xml:603 +#: Remoting.xml:594 #, no-c-format -msgid "" -"Seam Remoting provides experimental support for JMS Messaging. This section " -"describes the JMS support that is currently implemented, but please note " -"that this may change in the future. It is currently not recommended that " -"this feature is used within a production environment." +msgid "Seam Remoting provides experimental support for JMS Messaging. This section describes the JMS support that is currently implemented, but please note that this may change in the future. It is currently not recommended that this feature is used within a production environment." msgstr "" #. Tag: para -#: Remoting.xml:610 +#: Remoting.xml:601 #, no-c-format -msgid "" -"Before you can subscribe to a JMS topic, you must first configure a list of " -"the topics that can be subscribed to by Seam Remoting. List the topics under " -"<literal>org.jboss.seam.remoting.messaging.subscriptionRegistry." -"allowedTopics</literal> in <literal>seam.properties</literal>, <literal>web." -"xml</literal> or <literal>components.xml</literal>." +msgid "Before you can subscribe to a JMS topic, you must first configure a list of the topics that can be subscribed to by Seam Remoting. List the topics under <literal>org.jboss.seam.remoting.messaging.subscriptionRegistry.allowedTopics</literal> in <literal>seam.properties</literal>, <literal>web.xml</literal> or <literal>components.xml</literal>." msgstr "" #. Tag: programlisting -#: Remoting.xml:615 Remoting.xml:670 +#: Remoting.xml:606 +#: Remoting.xml:661 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" -msgstr "" -"<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" +msgstr "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" #. Tag: title -#: Remoting.xml:620 +#: Remoting.xml:611 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "Iscriversi ad un Topic JMS" #. Tag: para -#: Remoting.xml:622 +#: Remoting.xml:613 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:624 +#: Remoting.xml:615 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1742,125 +1310,90 @@ "Seam.Remoting.subscribe(\"topicName\", subscriptionCallback);" #. Tag: para -#: Remoting.xml:626 +#: Remoting.xml:617 #, no-c-format -msgid "" -"The <literal>Seam.Remoting.subscribe()</literal> method accepts two " -"parameters, the first being the name of the JMS Topic to subscribe to, the " -"second being the callback function to invoke when a message is received." +msgid "The <literal>Seam.Remoting.subscribe()</literal> method accepts two parameters, the first being the name of the JMS Topic to subscribe to, the second being the callback function to invoke when a message is received." msgstr "" #. Tag: para -#: Remoting.xml:629 +#: Remoting.xml:620 #, no-c-format -msgid "" -"There are two types of messages supported, Text messages and Object " -"messages. If you need to test for the type of message that is passed to your " -"callback function you can use the <literal>instanceof</literal> operator to " -"test whether the message is a <literal>Seam.Remoting.TextMessage</literal> " -"or <literal>Seam.Remoting.ObjectMessage</literal>. A <literal>TextMessage</" -"literal> contains the text value in its <literal>text</literal> field (or " -"alternatively call <literal>getText()</literal> on it), while an " -"<literal>ObjectMessage</literal> contains its object value in its " -"<literal>value</literal> field (or call its <literal>getValue()</literal> " -"method)." +msgid "There are two types of messages supported, Text messages and Object messages. If you need to test for the type of message that is passed to your callback function you can use the <literal>instanceof</literal> operator to test whether the message is a <literal>Seam.Remoting.TextMessage</literal> or <literal>Seam.Remoting.ObjectMessage</literal>. A <literal>TextMessage</literal> contains the text value in its <literal>text</literal> field (or alternatively call <literal>getText()</literal> on it), while an <literal>ObjectMessage</literal> contains its object value in its <literal>value</literal> field (or call its <literal>getValue()</literal> method)." msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:630 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "Disiscriversi da un Topic" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:632 #, no-c-format -msgid "" -"To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" -"literal> and pass in the topic name:" +msgid "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</literal> and pass in the topic name:" msgstr "" #. Tag: programlisting -#: Remoting.xml:644 +#: Remoting.xml:635 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "Seam.Remoting.unsubscribe(\"topicName\");" #. Tag: title -#: Remoting.xml:648 +#: Remoting.xml:639 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:641 #, no-c-format -msgid "" -"There are two parameters which you can modify to control how polling occurs. " -"The first one is <literal>Seam.Remoting.pollInterval</literal>, which " -"controls how long to wait between subsequent polls for new messages. This " -"parameter is expressed in seconds, and its default setting is 10." +msgid "There are two parameters which you can modify to control how polling occurs. The first one is <literal>Seam.Remoting.pollInterval</literal>, which controls how long to wait between subsequent polls for new messages. This parameter is expressed in seconds, and its default setting is 10." msgstr "" #. Tag: para -#: Remoting.xml:654 +#: Remoting.xml:645 #, no-c-format -msgid "" -"The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " -"also expressed as seconds. It controls how long a request to the server " -"should wait for a new message before timing out and sending an empty " -"response. Its default is 0 seconds, which means that when the server is " -"polled, if there are no messages ready for delivery then an empty response " -"will be immediately returned." +msgid "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is also expressed as seconds. It controls how long a request to the server should wait for a new message before timing out and sending an empty response. Its default is 0 seconds, which means that when the server is polled, if there are no messages ready for delivery then an empty response will be immediately returned." msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:650 #, no-c-format -msgid "" -"Caution should be used when setting a high <literal>pollTimeout</literal> " -"value; each request that has to wait for a message means that a server " -"thread is tied up until a message is received, or until the request times " -"out. If many such requests are being served simultaneously, it could mean a " -"large number of threads become tied up because of this reason." +msgid "Caution should be used when setting a high <literal>pollTimeout</literal> value; each request that has to wait for a message means that a server thread is tied up until a message is received, or until the request times out. If many such requests are being served simultaneously, it could mean a large number of threads become tied up because of this reason." msgstr "" #. Tag: para -#: Remoting.xml:664 +#: Remoting.xml:655 #, no-c-format -msgid "" -"It is recommended that you set these options via components.xml, however " -"they can be overridden via Javascript if desired. The following example " -"demonstrates how to configure the polling to occur much more aggressively. " -"You should set these parameters to suitable values for your application:" +msgid "It is recommended that you set these options via components.xml, however they can be overridden via Javascript if desired. The following example demonstrates how to configure the polling to occur much more aggressively. You should set these parameters to suitable values for your application:" msgstr "" #. Tag: para -#: Remoting.xml:668 +#: Remoting.xml:659 #, no-c-format msgid "Via components.xml:" msgstr "Via components.xml:" #. Tag: para -#: Remoting.xml:672 +#: Remoting.xml:663 #, no-c-format msgid "Via JavaScript:" msgstr "Via JavaScript:" #. Tag: programlisting -#: Remoting.xml:674 +#: Remoting.xml:665 #, no-c-format msgid "" -"// Only wait 1 second between receiving a poll response and sending the next " -"poll request.\n" +"// Only wait 1 second between receiving a poll response and sending the next poll request.\n" "Seam.Remoting.pollInterval = 1;\n" " \n" "// Wait up to 5 seconds on the server for new messages\n" "Seam.Remoting.pollTimeout = 5;" msgstr "" -"// Attendere 1 secondo tra la ricezione della risposta del pool e l'invio " -"della successiva richiesta di pool.\n" +"// Attendere 1 secondo tra la ricezione della risposta del pool e l'invio della successiva richiesta di pool.\n" "Seam.Remoting.pollInterval = 1;\n" " \n" "// Attendere fino a 5 secondi sul server per nuovi messaggi\n" "Seam.Remoting.pollTimeout = 5;" +

16 years, 11 months

1
0
0 / 0

Seam SVN: r10944 - in branches/community/Seam_2_1/doc/Seam_Reference_Guide: bn-IN and 23 other directories.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-23 07:40:36 -0400 (Sat, 23 May 2009) New Revision: 10944 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Remoting.po branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Remoting.po Log: Regenerated POT and updated all POs Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -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-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-11-06 00:09+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2009-03-17 21:41+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" @@ -22,12 +22,25 @@ #. Tag: para #: Remoting.xml:6 #, no-c-format -msgid "Seam provides a convenient method of remotely accessing components from a web page, using AJAX (Asynchronous Javascript and XML). The framework for this functionality is provided with almost no up-front development effort - your components only require simple annotating to become accessible via AJAX. This chapter describes the steps required to build an AJAX-enabled web page, then goes on to explain the features of the Seam Remoting framework in more detail." -msgstr "Seam fornisce un metodo per accedere in modo remoto i componenti da una pagina web, usando AJAX (Asynchronous Javascript and XML). Il framework per questa funzionalità viene fornito con quasi nessuno sforzo di sviluppo - i componenti richiedono solamente una semplice annotazione per diventare accessibile via AJAX. Questo capitolo descrive i passi richiesti per costruire una pagina web abilitata a AJAX, poi spiega con maggior dettaglio le caratteristiche del framework Seam Remoting." +msgid "" +"Seam provides a convenient method of remotely accessing components from a " +"web page, using AJAX (Asynchronous Javascript and XML). The framework for " +"this functionality is provided with almost no up-front development effort - " +"your components only require simple annotating to become accessible via " +"AJAX. This chapter describes the steps required to build an AJAX-enabled web " +"page, then goes on to explain the features of the Seam Remoting framework in " +"more detail." +msgstr "" +"Seam fornisce un metodo per accedere in modo remoto i componenti da una " +"pagina web, usando AJAX (Asynchronous Javascript and XML). Il framework per " +"questa funzionalità viene fornito con quasi nessuno sforzo di sviluppo - i " +"componenti richiedono solamente una semplice annotazione per diventare " +"accessibile via AJAX. Questo capitolo descrive i passi richiesti per " +"costruire una pagina web abilitata a AJAX, poi spiega con maggior dettaglio " +"le caratteristiche del framework Seam Remoting." #. Tag: title -#: Remoting.xml:13 -#: Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "Configurazione" @@ -35,8 +48,12 @@ #. Tag: para #: Remoting.xml:14 #, no-c-format -msgid "To use remoting, the Seam Resource servlet must first be configured in your <literal>web.xml</literal> file:" -msgstr "Per usare remoting, il resource servlet di Seam deve essere innanzitutto configurato nel file <literal>web.xml</literal>:" +msgid "" +"To use remoting, the Seam Resource servlet must first be configured in your " +"<literal>web.xml</literal> file:" +msgstr "" +"Per usare remoting, il resource servlet di Seam deve essere innanzitutto " +"configurato nel file <literal>web.xml</literal>:" #. Tag: programlisting #: Remoting.xml:16 @@ -65,52 +82,92 @@ #. Tag: para #: Remoting.xml:18 #, no-c-format -msgid "The next step is to import the necessary Javascript into your web page. There are a minimum of two scripts that must be imported. The first one contains all the client-side framework code that enables remoting functionality:" -msgstr "Il passo successivi è importare il Javascript necessario nella propria pagina web. Ci sono un minimo di due script da importare. Il primo contiene tutto il codice del framework lato client che abilita le funzionalità di remoting:" +msgid "" +"The next step is to import the necessary Javascript into your web page. " +"There are a minimum of two scripts that must be imported. The first one " +"contains all the client-side framework code that enables remoting " +"functionality:" +msgstr "" +"Il passo successivi è importare il Javascript necessario nella propria " +"pagina web. Ci sono un minimo di due script da importare. Il primo contiene " +"tutto il codice del framework lato client che abilita le funzionalità di " +"remoting:" #. Tag: programlisting #: Remoting.xml:22 #, no-c-format -msgid "<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/resource/remote.js\"></script>]]>" -msgstr "<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/resource/remote.js\"></script>]]>" +msgid "" +"<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/" +"resource/remote.js\"></script>]]>" +msgstr "" +"<![CDATA[<script type=\"text/javascript\" src=\"seam/resource/remoting/" +"resource/remote.js\"></script>]]>" #. Tag: para #: Remoting.xml:24 #, no-c-format -msgid "The second script contains the stubs and type definitions for the components you wish to call. It is generated dynamically based on the local interface of your components, and includes type definitions for all of the classes that can be used to call the remotable methods of the interface. The name of the script reflects the name of your component. For example, if you have a stateless session bean annotated with <literal>@Name(\"customerAction\")</literal>, then your script tag should look like this:" -msgstr "Il secondo script contiene gli stub e le definizioni tipo per i componenti da chiamare. Viene generato dinamicamente basandosi sull'interfaccia locale dei propri componenti, ed include le definizioni tipo per tutte le classi che possono essere usate per chiamare i metodi remoti dell'interfaccia. Il nome dello script riflette il nome del componente. Per esempio se si ha un bean di sessione stateless annotato con <literal>@Name(\"customerAction\")</literal>, allora il tag dello script dovrebbe essere simile a:" +msgid "" +"The second script contains the stubs and type definitions for the components " +"you wish to call. It is generated dynamically based on the local interface " +"of your components, and includes type definitions for all of the classes " +"that can be used to call the remotable methods of the interface. The name of " +"the script reflects the name of your component. For example, if you have a " +"stateless session bean annotated with <literal>@Name(\"customerAction\")</" +"literal>, then your script tag should look like this:" +msgstr "" +"Il secondo script contiene gli stub e le definizioni tipo per i componenti " +"da chiamare. Viene generato dinamicamente basandosi sull'interfaccia locale " +"dei propri componenti, ed include le definizioni tipo per tutte le classi " +"che possono essere usate per chiamare i metodi remoti dell'interfaccia. Il " +"nome dello script riflette il nome del componente. Per esempio se si ha un " +"bean di sessione stateless annotato con <literal>@Name(\"customerAction\")</" +"literal>, allora il tag dello script dovrebbe essere simile a:" #. Tag: programlisting #: Remoting.xml:30 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" #. Tag: para #: Remoting.xml:32 #, no-c-format -msgid "If you wish to access more than one component from the same page, then include them all as parameters of your script tag:" -msgstr "Se si vuole accedere a più di un componente dalla stessa pagina, allora li si includa tutti come parametri nel tag script:" +msgid "" +"If you wish to access more than one component from the same page, then " +"include them all as parameters of your script tag:" +msgstr "" +"Se si vuole accedere a più di un componente dalla stessa pagina, allora li " +"si includa tutti come parametri nel tag script:" #. Tag: programlisting #: Remoting.xml:35 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction&accountAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?" +"customerAction&accountAction\"></script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction&accountAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?" +"customerAction&accountAction\"></script>]]>" #. Tag: para #: Remoting.xml:38 #, no-c-format -msgid "Alternatively, you may use the <literal>s:remote</literal> tag to import the required Javascript. Separate each component or class name you wish to import with a comma:" -msgstr "In alternativa si può usare il tag <literal>s:remote</literal> per importare il Javascript richiesto. Si separi ciascun componente o nome di classe che si vuole importare con una virgola:" +msgid "" +"Alternatively, you may use the <literal>s:remote</literal> tag to import the " +"required Javascript. Separate each component or class name you wish to " +"import with a comma:" +msgstr "" +"In alternativa si può usare il tag <literal>s:remote</literal> per importare " +"il Javascript richiesto. Si separi ciascun componente o nome di classe che " +"si vuole importare con una virgola:" #. Tag: programlisting #: Remoting.xml:43 @@ -133,8 +190,24 @@ #. Tag: para #: Remoting.xml:50 #, no-c-format -msgid "Client-side interaction with your components is all performed via the <literal>Seam</literal> Javascript object. This object is defined in <literal>remote.js</literal>, and you'll be using it to make asynchronous calls against your component. It is split into two areas of functionality; <literal>Seam.Component</literal> contains methods for working with components and <literal>Seam.Remoting</literal> contains methods for executing remote requests. The easiest way to become familiar with this object is to start with a simple example." -msgstr "L'interazione lato client con i componenti viene eseguita tutta tramite l'oggetto Javascript <literal>Seam</literal>. Quest'oggetti è definito in <literal>remote.js</literal>, e lo si userà per fare chiamate asincrone verso il componente. E' suddiviso in due aree di funzionalità; <literal>Seam.Component</literal> contiene metodi per lavorare con i componenti e <literal>Seam.Remoting</literal> contiene metodi per eseguire le richieste remote. La via più facile per diventare familiare con quest'oggetto è cominciare con un semplice esempio." +msgid "" +"Client-side interaction with your components is all performed via the " +"<literal>Seam</literal> Javascript object. This object is defined in " +"<literal>remote.js</literal>, and you'll be using it to make asynchronous " +"calls against your component. It is split into two areas of functionality; " +"<literal>Seam.Component</literal> contains methods for working with " +"components and <literal>Seam.Remoting</literal> contains methods for " +"executing remote requests. The easiest way to become familiar with this " +"object is to start with a simple example." +msgstr "" +"L'interazione lato client con i componenti viene eseguita tutta tramite " +"l'oggetto Javascript <literal>Seam</literal>. Quest'oggetti è definito in " +"<literal>remote.js</literal>, e lo si userà per fare chiamate asincrone " +"verso il componente. E' suddiviso in due aree di funzionalità; <literal>Seam." +"Component</literal> contiene metodi per lavorare con i componenti e " +"<literal>Seam.Remoting</literal> contiene metodi per eseguire le richieste " +"remote. La via più facile per diventare familiare con quest'oggetto è " +"cominciare con un semplice esempio." #. Tag: title #: Remoting.xml:57 @@ -145,8 +218,13 @@ #. Tag: para #: Remoting.xml:59 #, no-c-format -msgid "Let's step through a simple example to see how the <literal>Seam</literal> object works. First of all, let's create a new Seam component called <literal>helloAction</literal>." -msgstr "Si cominci con un semplice esempio per vedere come funziona l'oggetto <literal>Seam</literal>" +msgid "" +"Let's step through a simple example to see how the <literal>Seam</literal> " +"object works. First of all, let's create a new Seam component called " +"<literal>helloAction</literal>." +msgstr "" +"Si cominci con un semplice esempio per vedere come funziona l'oggetto " +"<literal>Seam</literal>" #. Tag: programlisting #: Remoting.xml:62 @@ -171,7 +249,10 @@ #. Tag: para #: Remoting.xml:64 #, no-c-format -msgid "You also need to create a local interface for our new component - take special note of the <literal>@WebRemote</literal> annotation, as it's required to make our method accessible via remoting:" +msgid "" +"You also need to create a local interface for our new component - take " +"special note of the <literal>@WebRemote</literal> annotation, as it's " +"required to make our method accessible via remoting:" msgstr "" #. Tag: programlisting @@ -193,35 +274,61 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format -msgid "That's all the server-side code we need to write. Now for our web page - create a new page and import the <literal>helloAction</literal> component:" +msgid "That's all the server-side code we need to write." msgstr "" -#. Tag: programlisting +#. Tag: para #: Remoting.xml:72 #, no-c-format +msgid "" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." +msgstr "" + +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + +#. Tag: programlisting +#: Remoting.xml:81 +#, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"helloAction\"/>]]>" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format -msgid "To make this a fully interactive user experience, let's add a button to our page:" +msgid "" +"To make this a fully interactive user experience, let's add a button to our " +"page:" msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format -msgid "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" -msgstr "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" +msgid "" +"<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" +msgstr "" +"<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format -msgid "We'll also need to add some more script to make our button actually do something when it's clicked:" +msgid "" +"We'll also need to add some more script to make our button actually do " +"something when it's clicked:" msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -229,7 +336,8 @@ "\n" " function sayHello() {\n" " var name = prompt(\"What is your name?\");\n" -" Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);\n" +" Seam.Component.getInstance(\"helloAction\").sayHello(name, " +"sayHelloCallback);\n" " }\n" "\n" " function sayHelloCallback(result) {\n" @@ -244,7 +352,8 @@ "\n" " function sayHello() {\n" " var name = prompt(\"What is your name?\");\n" -" Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);\n" +" Seam.Component.getInstance(\"helloAction\").sayHello(name, " +"sayHelloCallback);\n" " }\n" "\n" " function sayHelloCallback(result) {\n" @@ -255,67 +364,108 @@ "</script>]]>" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format -msgid "We're done! Deploy your application and browse to your page. Click the button, and enter a name when prompted. A message box will display the hello message confirming that the call was successful. If you want to save some time, you'll find the full source code for this Hello World example in Seam's <literal>/examples/remoting/helloworld</literal> directory." +msgid "" +"We're done! Deploy your application and browse to your page. Click the " +"button, and enter a name when prompted. A message box will display the hello " +"message confirming that the call was successful. If you want to save some " +"time, you'll find the full source code for this Hello World example in " +"Seam's <literal>/examples/remoting/helloworld</literal> directory." msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format -msgid "So what does the code of our script actually do? Let's break it down into smaller pieces. To start with, you can see from the Javascript code listing that we have implemented two methods - the first method is responsible for prompting the user for their name and then making a remote request. Take a look at the following line:" +msgid "" +"So what does the code of our script actually do? Let's break it down into " +"smaller pieces. To start with, you can see from the Javascript code listing " +"that we have implemented two methods - the first method is responsible for " +"prompting the user for their name and then making a remote request. Take a " +"look at the following line:" msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format -msgid "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" -msgstr "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" +msgid "" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" +msgstr "" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format -msgid "The first section of this line, <literal>Seam.Component.getInstance(\"helloAction\")</literal> returns a proxy, or \"stub\" for our <literal>helloAction</literal> component. We can invoke the methods of our component against this stub, which is exactly what happens with the remainder of the line: <literal>sayHello(name, sayHelloCallback);</literal>." +msgid "" +"The first section of this line, <literal>Seam.Component.getInstance" +"(\"helloAction\")</literal> returns a proxy, or \"stub\" for our " +"<literal>helloAction</literal> component. We can invoke the methods of our " +"component against this stub, which is exactly what happens with the " +"remainder of the line: <literal>sayHello(name, sayHelloCallback);</literal>." msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format -msgid "What this line of code in its completeness does, is invoke the <literal>sayHello</literal> method of our component, passing in <literal>name</literal> as a parameter. The second parameter, <literal>sayHelloCallback</literal> isn't a parameter of our component's <literal>sayHello</literal> method, instead it tells the Seam Remoting framework that once it receives the response to our request, it should pass it to the <literal>sayHelloCallback</literal> Javascript method. This callback parameter is entirely optional, so feel free to leave it out if you're calling a method with a <literal>void</literal> return type or if you don't care about the result." +msgid "" +"What this line of code in its completeness does, is invoke the " +"<literal>sayHello</literal> method of our component, passing in " +"<literal>name</literal> as a parameter. The second parameter, " +"<literal>sayHelloCallback</literal> isn't a parameter of our component's " +"<literal>sayHello</literal> method, instead it tells the Seam Remoting " +"framework that once it receives the response to our request, it should pass " +"it to the <literal>sayHelloCallback</literal> Javascript method. This " +"callback parameter is entirely optional, so feel free to leave it out if " +"you're calling a method with a <literal>void</literal> return type or if you " +"don't care about the result." msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format -msgid "The <literal>sayHelloCallback</literal> method, once receiving the response to our remote request then pops up an alert message displaying the result of our method call." +msgid "" +"The <literal>sayHelloCallback</literal> method, once receiving the response " +"to our remote request then pops up an alert message displaying the result of " +"our method call." msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "Seam.Component" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format -msgid "The <literal>Seam.Component</literal> Javascript object provides a number of client-side methods for working with your Seam components. The two main methods, <literal>newInstance()</literal> and <literal>getInstance()</literal> are documented in the following sections however their main difference is that <literal>newInstance()</literal> will always create a new instance of a component type, and <literal>getInstance()</literal> will return a singleton instance." +msgid "" +"The <literal>Seam.Component</literal> Javascript object provides a number of " +"client-side methods for working with your Seam components. The two main " +"methods, <literal>newInstance()</literal> and <literal>getInstance()</" +"literal> are documented in the following sections however their main " +"difference is that <literal>newInstance()</literal> will always create a new " +"instance of a component type, and <literal>getInstance()</literal> will " +"return a singleton instance." msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "Seam.Component.newInstance()" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format -msgid "Use this method to create a new instance of an entity or Javabean component. The object returned by this method will have the same getter/setter methods as its server-side counterpart, or alternatively if you wish you can access its fields directly. Take the following Seam entity component for example:" +msgid "" +"Use this method to create a new instance of an entity or Javabean component. " +"The object returned by this method will have the same getter/setter methods " +"as its server-side counterpart, or alternatively if you wish you can access " +"its fields directly. Take the following Seam entity component for example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -385,25 +535,25 @@ "}" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "var customer = Seam.Component.newInstance(\"customer\");" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -415,43 +565,54 @@ "customer.lastName = \"Smith\";" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "Seam.Component.getInstance()" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format -msgid "The <literal>getInstance()</literal> method is used to get a reference to a Seam session bean component stub, which can then be used to remotely execute methods against your component. This method returns a singleton for the specified component, so calling it twice in a row with the same component name will return the same instance of the component." +msgid "" +"The <literal>getInstance()</literal> method is used to get a reference to a " +"Seam session bean component stub, which can then be used to remotely execute " +"methods against your component. This method returns a singleton for the " +"specified component, so calling it twice in a row with the same component " +"name will return the same instance of the component." msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format -msgid "To continue our example from before, if we have created a new <literal>customer</literal> and we now wish to save it, we would pass it to the <literal>saveCustomer()</literal> method of our <literal>customerAction</literal> component:" +msgid "" +"To continue our example from before, if we have created a new " +"<literal>customer</literal> and we now wish to save it, we would pass it to " +"the <literal>saveCustomer()</literal> method of our <literal>customerAction</" +"literal> component:" msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "Seam.Component.getComponentName()" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format -msgid "Passing an object into this method will return its component name if it is a component, or <literal>null</literal> if it is not." +msgid "" +"Passing an object into this method will return its component name if it is a " +"component, or <literal>null</literal> if it is not." msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -465,61 +626,81 @@ " alert(\"Staff member\");" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "Seam.Remoting" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format -msgid "Most of the client side functionality for Seam Remoting is contained within the <literal>Seam.Remoting</literal> object. While you shouldn't need to directly call most of its methods, there are a couple of important ones worth mentioning." +msgid "" +"Most of the client side functionality for Seam Remoting is contained within " +"the <literal>Seam.Remoting</literal> object. While you shouldn't need to " +"directly call most of its methods, there are a couple of important ones " +"worth mentioning." msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "Seam.Remoting.createType()" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format -msgid "If your application contains or uses Javabean classes that aren't Seam components, you may need to create these types on the client side to pass as parameters into your component method. Use the <literal>createType()</literal> method to create an instance of your type. Pass in the fully qualified Java class name as a parameter:" +msgid "" +"If your application contains or uses Javabean classes that aren't Seam " +"components, you may need to create these types on the client side to pass as " +"parameters into your component method. Use the <literal>createType()</" +"literal> method to create an instance of your type. Pass in the fully " +"qualified Java class name as a parameter:" msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "Seam.Remoting.getTypeName()" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format -msgid "This method is the equivalent of <literal>Seam.Component.getComponentName()</literal> but for non-component types. It will return the name of the type for an object instance, or <literal>null</literal> if the type is not known. The name is the fully qualified name of the type's Java class." +msgid "" +"This method is the equivalent of <literal>Seam.Component.getComponentName()</" +"literal> but for non-component types. It will return the name of the type " +"for an object instance, or <literal>null</literal> if the type is not known. " +"The name is the fully qualified name of the type's Java class." msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "Valutazione delle espressioni EL" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format -msgid "Seam Remoting also supports the evaluation of EL expressions, which provides another convenient method for retrieving data from the server. Using the <literal>Seam.Remoting.eval()</literal> function, an EL expression can be remotely evaluated on the server and the resulting value returned to a client-side callback method. This function accepts two parameters, the first being the EL expression to evaluate, and the second being the callback method to invoke with the value of the expression. Here's an example:" +msgid "" +"Seam Remoting also supports the evaluation of EL expressions, which provides " +"another convenient method for retrieving data from the server. Using the " +"<literal>Seam.Remoting.eval()</literal> function, an EL expression can be " +"remotely evaluated on the server and the resulting value returned to a " +"client-side callback method. This function accepts two parameters, the first " +"being the EL expression to evaluate, and the second being the callback " +"method to invoke with the value of the expression. Here's an example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -541,215 +722,313 @@ " ]]>" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format -msgid "In this example, the expression <literal>#{customers}</literal> is evaluated by Seam, and the value of the expression (in this case a list of Customer objects) is returned to the <literal>customersCallback()</literal> method. It is important to remember that the objects returned this way must have their types imported (via <literal>s:remote</literal>) to be able to work with them in Javascript. So to work with a list of <literal>customer</literal> objects, it is required to import the <literal>customer</literal> type:" +msgid "" +"In this example, the expression <literal>#{customers}</literal> is evaluated " +"by Seam, and the value of the expression (in this case a list of Customer " +"objects) is returned to the <literal>customersCallback()</literal> method. " +"It is important to remember that the objects returned this way must have " +"their types imported (via <literal>s:remote</literal>) to be able to work " +"with them in Javascript. So to work with a list of <literal>customer</" +"literal> objects, it is required to import the <literal>customer</literal> " +"type:" msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customer\"/>]]>" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "Interfacce client" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format -msgid "In the configuration section above, the interface, or \"stub\" for our component is imported into our page either via <literal>seam/resource/remoting/interface.js</literal>: or using the <literal>s:remote</literal> tag:" +msgid "" +"In the configuration section above, the interface, or \"stub\" for our " +"component is imported into our page either via <literal>seam/resource/" +"remoting/interface.js</literal>: or using the <literal>s:remote</literal> " +"tag:" msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" msgstr "" "<![CDATA[<script type=\"text/javascript\" \n" -" src=\"seam/resource/remoting/interface.js?customerAction\"></script>]]>" +" src=\"seam/resource/remoting/interface.js?customerAction\"></" +"script>]]>" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customerAction\"/>]]>" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format -msgid "By including this script in our page, the interface definitions for our component, plus any other components or types that are required to execute the methods of our component are generated and made available for the remoting framework to use." +msgid "" +"By including this script in our page, the interface definitions for our " +"component, plus any other components or types that are required to execute " +"the methods of our component are generated and made available for the " +"remoting framework to use." msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format -msgid "There are two types of client stub that can be generated, \"executable\" stubs and \"type\" stubs. Executable stubs are behavioural, and are used to execute methods against your session bean components, while type stubs contain state and represent the types that can be passed in as parameters or returned as a result." +msgid "" +"There are two types of client stub that can be generated, \"executable\" " +"stubs and \"type\" stubs. Executable stubs are behavioural, and are used to " +"execute methods against your session bean components, while type stubs " +"contain state and represent the types that can be passed in as parameters or " +"returned as a result." msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format -msgid "The type of client stub that is generated depends on the type of your Seam component. If the component is a session bean, then an executable stub will be generated, otherwise if it's an entity or JavaBean, then a type stub will be generated. There is one exception to this rule; if your component is a JavaBean (ie it is not a session bean nor an entity bean) and any of its methods are annotated with @WebRemote, then an executable stub will be generated for it instead of a type stub. This allows you to use remoting to call methods of your JavaBean components in a non-EJB environment where you don't have access to session beans." +msgid "" +"The type of client stub that is generated depends on the type of your Seam " +"component. If the component is a session bean, then an executable stub will " +"be generated, otherwise if it's an entity or JavaBean, then a type stub will " +"be generated. There is one exception to this rule; if your component is a " +"JavaBean (ie it is not a session bean nor an entity bean) and any of its " +"methods are annotated with @WebRemote, then an executable stub will be " +"generated for it instead of a type stub. This allows you to use remoting to " +"call methods of your JavaBean components in a non-EJB environment where you " +"don't have access to session beans." msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "Il contesto" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format -msgid "The Seam Remoting Context contains additional information which is sent and received as part of a remoting request/response cycle. At this stage it only contains the conversation ID but may be expanded in the future." +msgid "" +"The Seam Remoting Context contains additional information which is sent and " +"received as part of a remoting request/response cycle. At this stage it only " +"contains the conversation ID but may be expanded in the future." msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "Impostazione e lettura dell'ID di conversazione" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format -msgid "If you intend on using remote calls within the scope of a conversation then you need to be able to read or set the conversation ID in the Seam Remoting Context. To read the conversation ID after making a remote request call <literal>Seam.Remoting.getContext().getConversationId()</literal>. To set the conversation ID before making a request, call <literal>Seam.Remoting.getContext().setConversationId()</literal>." +msgid "" +"If you intend on using remote calls within the scope of a conversation then " +"you need to be able to read or set the conversation ID in the Seam Remoting " +"Context. To read the conversation ID after making a remote request call " +"<literal>Seam.Remoting.getContext().getConversationId()</literal>. To set " +"the conversation ID before making a request, call <literal>Seam.Remoting." +"getContext().setConversationId()</literal>." msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format -msgid "If the conversation ID hasn't been explicitly set with <literal>Seam.Remoting.getContext().setConversationId()</literal>, then it will be automatically assigned the first valid conversation ID that is returned by any remoting call. If you are working with multiple conversations within your page, then you may need to explicitly set the conversation ID before each call. If you are working with just a single conversation, then you don't need to do anything special." +msgid "" +"If the conversation ID hasn't been explicitly set with <literal>Seam." +"Remoting.getContext().setConversationId()</literal>, then it will be " +"automatically assigned the first valid conversation ID that is returned by " +"any remoting call. If you are working with multiple conversations within " +"your page, then you may need to explicitly set the conversation ID before " +"each call. If you are working with just a single conversation, then you " +"don't need to do anything special." msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format -msgid "In some circumstances it may be required to make a remote call within the scope of the current view's conversation. To do this, you must explicitly set the conversation ID to that of the view before making the remote call. This small snippet of JavaScript will set the conversation ID that is used for remoting calls to the current view's conversation ID:" +msgid "" +"In some circumstances it may be required to make a remote call within the " +"scope of the current view's conversation. To do this, you must explicitly " +"set the conversation ID to that of the view before making the remote call. " +"This small snippet of JavaScript will set the conversation ID that is used " +"for remoting calls to the current view's conversation ID:" msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format -msgid "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation.id} );]]>" -msgstr "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation.id} );]]>" +msgid "" +"<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." +"id} );]]>" +msgstr "" +"<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." +"id} );]]>" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "Richieste batch" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format -msgid "Seam Remoting allows multiple component calls to be executed within a single request. It is recommended that this feature is used wherever it is appropriate to reduce network traffic." +msgid "" +"Seam Remoting allows multiple component calls to be executed within a single " +"request. It is recommended that this feature is used wherever it is " +"appropriate to reduce network traffic." msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format -msgid "The method <literal>Seam.Remoting.startBatch()</literal> will start a new batch, and any component calls executed after starting a batch are queued, rather than being sent immediately. When all the desired component calls have been added to the batch, the <literal>Seam.Remoting.executeBatch()</literal> method will send a single request containing all of the queued calls to the server, where they will be executed in order. After the calls have been executed, a single response containining all return values will be returned to the client and the callback functions (if provided) triggered in the same order as execution." +msgid "" +"The method <literal>Seam.Remoting.startBatch()</literal> will start a new " +"batch, and any component calls executed after starting a batch are queued, " +"rather than being sent immediately. When all the desired component calls " +"have been added to the batch, the <literal>Seam.Remoting.executeBatch()</" +"literal> method will send a single request containing all of the queued " +"calls to the server, where they will be executed in order. After the calls " +"have been executed, a single response containining all return values will be " +"returned to the client and the callback functions (if provided) triggered in " +"the same order as execution." msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format -msgid "If you start a new batch via the <literal>startBatch()</literal> method but then decide you don't want to send it, the <literal>Seam.Remoting.cancelBatch()</literal> method will discard any calls that were queued and exit the batch mode." +msgid "" +"If you start a new batch via the <literal>startBatch()</literal> method but " +"then decide you don't want to send it, the <literal>Seam.Remoting.cancelBatch" +"()</literal> method will discard any calls that were queued and exit the " +"batch mode." msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format -msgid "To see an example of a batch being used, take a look at <literal>/examples/remoting/chatroom</literal>." +msgid "" +"To see an example of a batch being used, take a look at <literal>/examples/" +"remoting/chatroom</literal>." msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "Lavorare con i tipi di dati" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format -msgid "This section describes the support for basic data types. On the server side these values are generally compatible with either their primitive type or their corresponding wrapper class." +msgid "" +"This section describes the support for basic data types. On the server side " +"these values are generally compatible with either their primitive type or " +"their corresponding wrapper class." msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "String" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format -msgid "Simply use Javascript String objects when setting String parameter values." +msgid "" +"Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "Number" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format -msgid "There is support for all number types supported by Java. On the client side, number values are always serialized as their String representation and then on the server side they are converted to the correct destination type. Conversion into either a primitive or wrapper type is supported for <literal>Byte</literal>, <literal>Double</literal>, <literal>Float</literal>, <literal>Integer</literal>, <literal>Long</literal> and <literal>Short</literal> types." +msgid "" +"There is support for all number types supported by Java. On the client side, " +"number values are always serialized as their String representation and then " +"on the server side they are converted to the correct destination type. " +"Conversion into either a primitive or wrapper type is supported for " +"<literal>Byte</literal>, <literal>Double</literal>, <literal>Float</" +"literal>, <literal>Integer</literal>, <literal>Long</literal> and " +"<literal>Short</literal> types." msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "Boolean" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format -msgid "Booleans are represented client side by Javascript Boolean values, and server side by a Java boolean." +msgid "" +"Booleans are represented client side by Javascript Boolean values, and " +"server side by a Java boolean." msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "JavaBeans" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format -msgid "In general these will be either Seam entity or JavaBean components, or some other non-component class. Use the appropriate method (either <literal>Seam.Component.newInstance()</literal> for Seam components or <literal>Seam.Remoting.createType()</literal> for everything else) to create a new instance of the object." +msgid "" +"In general these will be either Seam entity or JavaBean components, or some " +"other non-component class. Use the appropriate method (either <literal>Seam." +"Component.newInstance()</literal> for Seam components or <literal>Seam." +"Remoting.createType()</literal> for everything else) to create a new " +"instance of the object." msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format -msgid "It is important to note that only objects that are created by either of these two methods should be used as parameter values, where the parameter is not one of the other valid types mentioned anywhere else in this section. In some situations you may have a component method where the exact parameter type cannot be determined, such as:" +msgid "" +"It is important to note that only objects that are created by either of " +"these two methods should be used as parameter values, where the parameter is " +"not one of the other valid types mentioned anywhere else in this section. In " +"some situations you may have a component method where the exact parameter " +"type cannot be determined, such as:" msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -767,49 +1046,70 @@ "}" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format -msgid "In this case you might want to pass in an instance of your <literal>myWidget</literal> component, however the interface for <literal>myAction</literal> won't include <literal>myWidget</literal> as it is not directly referenced by any of its methods. To get around this, <literal>MyWidget</literal> needs to be explicitly imported:" +msgid "" +"In this case you might want to pass in an instance of your " +"<literal>myWidget</literal> component, however the interface for " +"<literal>myAction</literal> won't include <literal>myWidget</literal> as it " +"is not directly referenced by any of its methods. To get around this, " +"<literal>MyWidget</literal> needs to be explicitly imported:" msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format -msgid "This will then allow a <literal>myWidget</literal> object to be created with <literal>Seam.Component.newInstance(\"myWidget\")</literal>, which can then be passed to <literal>myAction.doSomethingWithObject()</literal>." +msgid "" +"This will then allow a <literal>myWidget</literal> object to be created with " +"<literal>Seam.Component.newInstance(\"myWidget\")</literal>, which can then " +"be passed to <literal>myAction.doSomethingWithObject()</literal>." msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "Date e orari" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format -msgid "Date values are serialized into a String representation that is accurate to the millisecond. On the client side, use a Javascript Date object to work with date values. On the server side, use any <literal>java.util.Date</literal> (or descendent, such as <literal>java.sql.Date</literal> or <literal>java.sql.Timestamp</literal> class." -msgstr "I valori delle date sono serializzati in una rappresentazione di Strina che è accurata al millisecondo. Lato client, si usi un oggetto Date Javascript per lavorare con i valori delle date. Late server, si usi <literal>java.util.Date</literal> (o discendenti, come le classi <literal>java.sql.Date</literal> o <literal>java.sql.Timestamp</literal>)." +msgid "" +"Date values are serialized into a String representation that is accurate to " +"the millisecond. On the client side, use a Javascript Date object to work " +"with date values. On the server side, use any <literal>java.util.Date</" +"literal> (or descendent, such as <literal>java.sql.Date</literal> or " +"<literal>java.sql.Timestamp</literal> class." +msgstr "" +"I valori delle date sono serializzati in una rappresentazione di Strina che " +"è accurata al millisecondo. Lato client, si usi un oggetto Date Javascript " +"per lavorare con i valori delle date. Late server, si usi <literal>java.util." +"Date</literal> (o discendenti, come le classi <literal>java.sql.Date</" +"literal> o <literal>java.sql.Timestamp</literal>)." #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "Enums" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format -msgid "On the client side, enums are treated the same as Strings. When setting the value for an enum parameter, simply use the String representation of the enum. Take the following component as an example:" +msgid "" +"On the client side, enums are treated the same as Strings. When setting the " +"value for an enum parameter, simply use the String representation of the " +"enum. Take the following component as an example:" msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -831,191 +1131,255 @@ "}" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format -msgid "To call the <literal>paint()</literal> method with the color <literal>red</literal>, pass the parameter value as a String literal:" +msgid "" +"To call the <literal>paint()</literal> method with the color <literal>red</" +"literal>, pass the parameter value as a String literal:" msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format -msgid "The inverse is also true - that is, if a component method returns an enum parameter (or contains an enum field anywhere in the returned object graph) then on the client-side it will be represented as a String." +msgid "" +"The inverse is also true - that is, if a component method returns an enum " +"parameter (or contains an enum field anywhere in the returned object graph) " +"then on the client-side it will be represented as a String." msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "Collections" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "Bags" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format -msgid "Bags cover all collection types including arrays, collections, lists, sets, (but excluding Maps - see the next section for those), and are implemented client-side as a Javascript array. When calling a component method that accepts one of these types as a parameter, your parameter should be a Javascript array. If a component method returns one of these types, then the return value will also be a Javascript array. The remoting framework is clever enough on the server side to convert the bag to an appropriate type for the component method call." +msgid "" +"Bags cover all collection types including arrays, collections, lists, sets, " +"(but excluding Maps - see the next section for those), and are implemented " +"client-side as a Javascript array. When calling a component method that " +"accepts one of these types as a parameter, your parameter should be a " +"Javascript array. If a component method returns one of these types, then the " +"return value will also be a Javascript array. The remoting framework is " +"clever enough on the server side to convert the bag to an appropriate type " +"for the component method call." msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "Maps" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format -msgid "As there is no native support for Maps within Javascript, a simple Map implementation is provided with the Seam Remoting framework. To create a Map which can be used as a parameter to a remote call, create a new <literal>Seam.Remoting.Map</literal> object:" +msgid "" +"As there is no native support for Maps within Javascript, a simple Map " +"implementation is provided with the Seam Remoting framework. To create a Map " +"which can be used as a parameter to a remote call, create a new " +"<literal>Seam.Remoting.Map</literal> object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "var map = new Seam.Remoting.Map();" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format -msgid "This Javascript implementation provides basic methods for working with Maps: <literal>size()</literal>, <literal>isEmpty()</literal>, <literal>keySet()</literal>, <literal>values()</literal>, <literal>get(key)</literal>, <literal>put(key, value)</literal>, <literal>remove(key)</literal> and <literal>contains(key)</literal>. Each of these methods are equivalent to their Java counterpart. Where the method returns a collection, such as <literal>keySet()</literal> and <literal>values()</literal>, a Javascript Array object will be returned that contains the key or value objects (respectively)." +msgid "" +"This Javascript implementation provides basic methods for working with Maps: " +"<literal>size()</literal>, <literal>isEmpty()</literal>, <literal>keySet()</" +"literal>, <literal>values()</literal>, <literal>get(key)</literal>, " +"<literal>put(key, value)</literal>, <literal>remove(key)</literal> and " +"<literal>contains(key)</literal>. Each of these methods are equivalent to " +"their Java counterpart. Where the method returns a collection, such as " +"<literal>keySet()</literal> and <literal>values()</literal>, a Javascript " +"Array object will be returned that contains the key or value objects " +"(respectively)." msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "Debugging" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format -msgid "To aid in tracking down bugs, it is possible to enable a debug mode which will display the contents of all the packets send back and forth between the client and server in a popup window. To enable debug mode, either execute the <literal>setDebug()</literal> method in Javascript:" +msgid "" +"To aid in tracking down bugs, it is possible to enable a debug mode which " +"will display the contents of all the packets send back and forth between the " +"client and server in a popup window. To enable debug mode, either execute " +"the <literal>setDebug()</literal> method in Javascript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "Seam.Remoting.setDebug(true);" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "O lo si configuri via components.xml:" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format -msgid "To turn off debugging, call <literal>setDebug(false)</literal>. If you want to write your own messages to the debug log, call <literal>Seam.Remoting.log(message)</literal>." +msgid "" +"To turn off debugging, call <literal>setDebug(false)</literal>. If you want " +"to write your own messages to the debug log, call <literal>Seam.Remoting.log" +"(message)</literal>." msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "Gestione delle eccezioni" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format -msgid "When invoking a remote component method, it is possible to specify an exception handler which will process the response in the event of an exception during component invocation. To specify an exception handler function, include a reference to it after the callback parameter in your JavaScript:" +msgid "" +"When invoking a remote component method, it is possible to specify an " +"exception handler which will process the response in the event of an " +"exception during component invocation. To specify an exception handler " +"function, include a reference to it after the callback parameter in your " +"JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" -"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, exceptionHandler);]]>" +"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex." +"getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, " +"exceptionHandler);]]>" msgstr "" "<![CDATA[var callback = function(result) { alert(result); };\n" -"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, exceptionHandler);]]>" +"var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex." +"getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, callback, " +"exceptionHandler);]]>" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format -msgid "If you do not have a callback handler defined, you must specify <literal>null</literal> in its place:" +msgid "" +"If you do not have a callback handler defined, you must specify " +"<literal>null</literal> in its place:" msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" -"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, exceptionHandler);]]>" +"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " +"occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, " +"exceptionHandler);]]>" msgstr "" -"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception occurred: \" + ex.getMessage()); };\n" -"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, exceptionHandler);]]>" +"<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " +"occurred: \" + ex.getMessage()); };\n" +"Seam.Component.getInstance(\"helloAction\").sayHello(name, null, " +"exceptionHandler);]]>" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format -msgid "The exception object that is passed to the exception handler exposes one method, <literal>getMessage()</literal> that returns the exception message which is produced by the exception thrown by the <literal>@WebRemote</literal> method." +msgid "" +"The exception object that is passed to the exception handler exposes one " +"method, <literal>getMessage()</literal> that returns the exception message " +"which is produced by the exception thrown by the <literal>@WebRemote</" +"literal> method." msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "Il messaggio di caricamento" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format -msgid "The default loading message that appears in the top right corner of the screen can be modified, its rendering customised or even turned off completely." +msgid "" +"The default loading message that appears in the top right corner of the " +"screen can be modified, its rendering customised or even turned off " +"completely." msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "Cambiare il messaggio" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format -msgid "To change the message from the default \"Please Wait...\" to something different, set the value of <literal>Seam.Remoting.loadingMessage</literal>:" -msgstr "Per cambiare il messaggio dal default \"Attendere prego...\" a qualcosa di differente, si imposti il valore di <literal>Seam.Remoting.loadingMessage</literal>:" +msgid "" +"To change the message from the default \"Please Wait...\" to something " +"different, set the value of <literal>Seam.Remoting.loadingMessage</literal>:" +msgstr "" +"Per cambiare il messaggio dal default \"Attendere prego...\" a qualcosa di " +"differente, si imposti il valore di <literal>Seam.Remoting.loadingMessage</" +"literal>:" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "Seam.Remoting.loadingMessage = \"Loading...\";" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "Nascondere il messaggio di caricamento" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format -msgid "To completely suppress the display of the loading message, override the implementation of <literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()</literal> with functions that instead do nothing:" +msgid "" +"To completely suppress the display of the loading message, override the " +"implementation of <literal>displayLoadingMessage()</literal> and " +"<literal>hideLoadingMessage()</literal> with functions that instead do " +"nothing:" msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1027,19 +1391,23 @@ "Seam.Remoting.hideLoadingMessage = function() {};" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format -msgid "It is also possible to override the loading indicator to display an animated icon, or anything else that you want. To do this override the <literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()</literal> messages with your own implementation:" +msgid "" +"It is also possible to override the loading indicator to display an animated " +"icon, or anything else that you want. To do this override the " +"<literal>displayLoadingMessage()</literal> and <literal>hideLoadingMessage()" +"</literal> messages with your own implementation:" msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1059,31 +1427,49 @@ " };" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format -msgid "When a remote method is executed, the result is serialized into an XML response that is returned to the client. This response is then unmarshaled by the client into a Javascript object. For complex types (i.e. Javabeans) that include references to other objects, all of these referenced objects are also serialized as part of the response. These objects may reference other objects, which may reference other objects, and so forth. If left unchecked, this object \"graph\" could potentially be enormous, depending on what relationships exist between your objects. And as a side issue (besides the potential verbosity of the response), you might also wish to prevent sensitive information from being exposed to the client." +msgid "" +"When a remote method is executed, the result is serialized into an XML " +"response that is returned to the client. This response is then unmarshaled " +"by the client into a Javascript object. For complex types (i.e. Javabeans) " +"that include references to other objects, all of these referenced objects " +"are also serialized as part of the response. These objects may reference " +"other objects, which may reference other objects, and so forth. If left " +"unchecked, this object \"graph\" could potentially be enormous, depending on " +"what relationships exist between your objects. And as a side issue (besides " +"the potential verbosity of the response), you might also wish to prevent " +"sensitive information from being exposed to the client." msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format -msgid "Seam Remoting provides a simple means to \"constrain\" the object graph, by specifying the <literal>exclude</literal> field of the remote method's <literal>@WebRemote</literal> annotation. This field accepts a String array containing one or more paths specified using dot notation. When invoking a remote method, the objects in the result's object graph that match these paths are excluded from the serialized result packet." +msgid "" +"Seam Remoting provides a simple means to \"constrain\" the object graph, by " +"specifying the <literal>exclude</literal> field of the remote method's " +"<literal>@WebRemote</literal> annotation. This field accepts a String array " +"containing one or more paths specified using dot notation. When invoking a " +"remote method, the objects in the result's object graph that match these " +"paths are excluded from the serialized result packet." msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format -msgid "For all our examples, we'll use the following <literal>Widget</literal> class:" +msgid "" +"For all our examples, we'll use the following <literal>Widget</literal> " +"class:" msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1111,19 +1497,22 @@ "}" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format -msgid "If your remote method returns an instance of <literal>Widget</literal>, but you don't want to expose the <literal>secret</literal> field because it contains sensitive information, you would constrain it like this:" +msgid "" +"If your remote method returns an instance of <literal>Widget</literal>, but " +"you don't want to expose the <literal>secret</literal> field because it " +"contains sensitive information, you would constrain it like this:" msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1133,13 +1522,21 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format -msgid "The value \"secret\" refers to the <literal>secret</literal> field of the returned object. Now, suppose that we don't care about exposing this particular field to the client. Instead, notice that the <literal>Widget</literal> value that is returned has a field <literal>child</literal> that is also a <literal>Widget</literal>. What if we want to hide the <literal>child</literal>'s <literal>secret</literal> value instead? We can do this by using dot notation to specify this field's path within the result's object graph:" +msgid "" +"The value \"secret\" refers to the <literal>secret</literal> field of the " +"returned object. Now, suppose that we don't care about exposing this " +"particular field to the client. Instead, notice that the <literal>Widget</" +"literal> value that is returned has a field <literal>child</literal> that is " +"also a <literal>Widget</literal>. What if we want to hide the " +"<literal>child</literal>'s <literal>secret</literal> value instead? We can " +"do this by using dot notation to specify this field's path within the " +"result's object graph:" msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1149,19 +1546,27 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format -msgid "The other place that objects can exist within an object graph are within a <literal>Map</literal> or some kind of collection (<literal>List</literal>, <literal>Set</literal>, <literal>Array</literal>, etc). Collections are easy, and are treated like any other field. For example, if our <literal>Widget</literal> contained a list of other <literal>Widget</literal>s in its <literal>widgetList</literal> field, to constrain the <literal>secret</literal> field of the <literal>Widget</literal>s in this list the annotation would look like this:" +msgid "" +"The other place that objects can exist within an object graph are within a " +"<literal>Map</literal> or some kind of collection (<literal>List</literal>, " +"<literal>Set</literal>, <literal>Array</literal>, etc). Collections are " +"easy, and are treated like any other field. For example, if our " +"<literal>Widget</literal> contained a list of other <literal>Widget</" +"literal>s in its <literal>widgetList</literal> field, to constrain the " +"<literal>secret</literal> field of the <literal>Widget</literal>s in this " +"list the annotation would look like this:" msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1171,13 +1576,20 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format -msgid "To constrain a <literal>Map</literal>'s key or value, the notation is slightly different. Appending <literal>[key]</literal> after the <literal>Map</literal>'s field name will constrain the <literal>Map</literal>'s key object values, while <literal>[value]</literal> will constrain the value object values. The following example demonstrates how the values of the <literal>widgetMap</literal> field have their <literal>secret</literal> field constrained:" +msgid "" +"To constrain a <literal>Map</literal>'s key or value, the notation is " +"slightly different. Appending <literal>[key]</literal> after the " +"<literal>Map</literal>'s field name will constrain the <literal>Map</" +"literal>'s key object values, while <literal>[value]</literal> will " +"constrain the value object values. The following example demonstrates how " +"the values of the <literal>widgetMap</literal> field have their " +"<literal>secret</literal> field constrained:" msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1187,19 +1599,24 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format -msgid "There is one last notation that can be used to constrain the fields of a type of object no matter where in the result's object graph it appears. This notation uses either the name of the component (if the object is a Seam component) or the fully qualified class name (only if the object is not a Seam component) and is expressed using square brackets:" +msgid "" +"There is one last notation that can be used to constrain the fields of a " +"type of object no matter where in the result's object graph it appears. This " +"notation uses either the name of the component (if the object is a Seam " +"component) or the fully qualified class name (only if the object is not a " +"Seam component) and is expressed using square brackets:" msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1209,19 +1626,21 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format -msgid "Constraints can also be combined, to filter objects from multiple paths within the object graph:" +msgid "" +"Constraints can also be combined, to filter objects from multiple paths " +"within the object graph:" msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1231,19 +1650,23 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "Richieste transazionali" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format -msgid "By default there is no active transaction during a remoting request, so if you wish to perform database updates during a remoting request, you need to annotate the <literal>@WebRemote</literal> method with <literal>@Transactional</literal>, like so:" +msgid "" +"By default there is no active transaction during a remoting request, so if " +"you wish to perform database updates during a remoting request, you need to " +"annotate the <literal>@WebRemote</literal> method with " +"<literal>@Transactional</literal>, like so:" msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1253,44 +1676,53 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "Messaggistica JMS" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format -msgid "Seam Remoting provides experimental support for JMS Messaging. This section describes the JMS support that is currently implemented, but please note that this may change in the future. It is currently not recommended that this feature is used within a production environment." +msgid "" +"Seam Remoting provides experimental support for JMS Messaging. This section " +"describes the JMS support that is currently implemented, but please note " +"that this may change in the future. It is currently not recommended that " +"this feature is used within a production environment." msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format -msgid "Before you can subscribe to a JMS topic, you must first configure a list of the topics that can be subscribed to by Seam Remoting. List the topics under <literal>org.jboss.seam.remoting.messaging.subscriptionRegistry.allowedTopics</literal> in <literal>seam.properties</literal>, <literal>web.xml</literal> or <literal>components.xml</literal>." +msgid "" +"Before you can subscribe to a JMS topic, you must first configure a list of " +"the topics that can be subscribed to by Seam Remoting. List the topics under " +"<literal>org.jboss.seam.remoting.messaging.subscriptionRegistry." +"allowedTopics</literal> in <literal>seam.properties</literal>, <literal>web." +"xml</literal> or <literal>components.xml</literal>." msgstr "" #. Tag: programlisting -#: Remoting.xml:606 -#: Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" -msgstr "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" +msgstr "" +"<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "Iscriversi ad un Topic JMS" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1310,90 +1742,125 @@ "Seam.Remoting.subscribe(\"topicName\", subscriptionCallback);" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format -msgid "The <literal>Seam.Remoting.subscribe()</literal> method accepts two parameters, the first being the name of the JMS Topic to subscribe to, the second being the callback function to invoke when a message is received." +msgid "" +"The <literal>Seam.Remoting.subscribe()</literal> method accepts two " +"parameters, the first being the name of the JMS Topic to subscribe to, the " +"second being the callback function to invoke when a message is received." msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format -msgid "There are two types of messages supported, Text messages and Object messages. If you need to test for the type of message that is passed to your callback function you can use the <literal>instanceof</literal> operator to test whether the message is a <literal>Seam.Remoting.TextMessage</literal> or <literal>Seam.Remoting.ObjectMessage</literal>. A <literal>TextMessage</literal> contains the text value in its <literal>text</literal> field (or alternatively call <literal>getText()</literal> on it), while an <literal>ObjectMessage</literal> contains its object value in its <literal>value</literal> field (or call its <literal>getValue()</literal> method)." +msgid "" +"There are two types of messages supported, Text messages and Object " +"messages. If you need to test for the type of message that is passed to your " +"callback function you can use the <literal>instanceof</literal> operator to " +"test whether the message is a <literal>Seam.Remoting.TextMessage</literal> " +"or <literal>Seam.Remoting.ObjectMessage</literal>. A <literal>TextMessage</" +"literal> contains the text value in its <literal>text</literal> field (or " +"alternatively call <literal>getText()</literal> on it), while an " +"<literal>ObjectMessage</literal> contains its object value in its " +"<literal>value</literal> field (or call its <literal>getValue()</literal> " +"method)." msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "Disiscriversi da un Topic" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format -msgid "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</literal> and pass in the topic name:" +msgid "" +"To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" +"literal> and pass in the topic name:" msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "Seam.Remoting.unsubscribe(\"topicName\");" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format -msgid "There are two parameters which you can modify to control how polling occurs. The first one is <literal>Seam.Remoting.pollInterval</literal>, which controls how long to wait between subsequent polls for new messages. This parameter is expressed in seconds, and its default setting is 10." +msgid "" +"There are two parameters which you can modify to control how polling occurs. " +"The first one is <literal>Seam.Remoting.pollInterval</literal>, which " +"controls how long to wait between subsequent polls for new messages. This " +"parameter is expressed in seconds, and its default setting is 10." msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format -msgid "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is also expressed as seconds. It controls how long a request to the server should wait for a new message before timing out and sending an empty response. Its default is 0 seconds, which means that when the server is polled, if there are no messages ready for delivery then an empty response will be immediately returned." +msgid "" +"The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " +"also expressed as seconds. It controls how long a request to the server " +"should wait for a new message before timing out and sending an empty " +"response. Its default is 0 seconds, which means that when the server is " +"polled, if there are no messages ready for delivery then an empty response " +"will be immediately returned." msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format -msgid "Caution should be used when setting a high <literal>pollTimeout</literal> value; each request that has to wait for a message means that a server thread is tied up until a message is received, or until the request times out. If many such requests are being served simultaneously, it could mean a large number of threads become tied up because of this reason." +msgid "" +"Caution should be used when setting a high <literal>pollTimeout</literal> " +"value; each request that has to wait for a message means that a server " +"thread is tied up until a message is received, or until the request times " +"out. If many such requests are being served simultaneously, it could mean a " +"large number of threads become tied up because of this reason." msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format -msgid "It is recommended that you set these options via components.xml, however they can be overridden via Javascript if desired. The following example demonstrates how to configure the polling to occur much more aggressively. You should set these parameters to suitable values for your application:" +msgid "" +"It is recommended that you set these options via components.xml, however " +"they can be overridden via Javascript if desired. The following example " +"demonstrates how to configure the polling to occur much more aggressively. " +"You should set these parameters to suitable values for your application:" msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "Via components.xml:" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "Via JavaScript:" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" -"// Only wait 1 second between receiving a poll response and sending the next poll request.\n" +"// Only wait 1 second between receiving a poll response and sending the next " +"poll request.\n" "Seam.Remoting.pollInterval = 1;\n" " \n" "// Wait up to 5 seconds on the server for new messages\n" "Seam.Remoting.pollTimeout = 5;" msgstr "" -"// Attendere 1 secondo tra la ricezione della risposta del pool e l'invio della successiva richiesta di pool.\n" +"// Attendere 1 secondo tra la ricezione della risposta del pool e l'invio " +"della successiva richiesta di pool.\n" "Seam.Remoting.pollInterval = 1;\n" " \n" "// Attendere fino a 5 secondi sul server per nuovi messaggi\n" "Seam.Remoting.pollTimeout = 5;" - Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -4,7 +4,7 @@ msgstr "" "Project-Id-Version: Remoting\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-22 12:51+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2009-03-06 10:13+1000\n" "Last-Translator: Noriko Mizumoto <noriko(a)redhat.com>\n" "Language-Team: Japanese <fedora-trans-ja(a)redhat.com>\n" @@ -39,7 +39,7 @@ "述べ、そしてSeam Remoting フレームワークの機能についても詳しく説明します。" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "設定" @@ -276,22 +276,40 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" + +#. Tag: para +#: Remoting.xml:78 +#, fuzzy, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" "書く必要があるサーバサイドのコードはこれだけです。それでは、WEB ページのため" "に - 新しいページを作成して、 <literal>helloAction</literal> コンポーネントを" "インポートしましょう。" #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"helloAction\"/>]]>" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -301,7 +319,7 @@ "す。" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" @@ -309,7 +327,7 @@ "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -319,7 +337,7 @@ "少し追加する必要があります。" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -355,7 +373,7 @@ "</script>]]>" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -371,7 +389,7 @@ "literal> ディレクトリにこの Hello World サンプルの全ソースコードがあります。" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -386,7 +404,7 @@ "求を行うのがその役割です。以下の行から見てみましょう。" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" @@ -394,7 +412,7 @@ "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -410,7 +428,7 @@ "sayHelloCallback);</literal> になります。" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -435,7 +453,7 @@ "がない場合は、遠慮なくそのままにしてください。" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -447,13 +465,13 @@ "す。" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "Seam.Component" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -473,13 +491,13 @@ "す。" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "Seam.Component.newInstance()" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -494,7 +512,7 @@ "以下の Seam エンティティコンポーネントをご覧ください。" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -564,26 +582,26 @@ "}" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" "クライアントサイド Customer を生成するために、以下のコードを記述します。" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "var customer = Seam.Component.newInstance(\"customer\");" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "そして、ここからは customer オブジェクトのフィールドの設定が可能です。" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -595,13 +613,13 @@ "customer.lastName = \"Smith\";" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "Seam.Component.getInstance()" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -617,7 +635,7 @@ "出すと、同じコンポーネントインスタンスが返されます。" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -630,19 +648,19 @@ "<literal>saveCustomer()</literal>メソッドにそれを渡します。" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "Seam.Component.getComponentName()" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -652,7 +670,7 @@ "し、コンポーネントではない場合には <literal>null</literal> を返します。" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -666,13 +684,13 @@ " alert(\"Staff member\");" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "Seam.Remoting" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -685,13 +703,13 @@ "え、言及する価値のある重要なものがあります。" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "Seam.Remoting.createType()" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -707,19 +725,19 @@ "ラメータとして、完全修飾の Java クラス名を渡してください。" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "Seam.Remoting.getTypeName()" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -733,13 +751,13 @@ "返します。この名前は、タイプの Java クラス完全修飾名です。" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "EL 式を評価する" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -758,7 +776,7 @@ "の式の値を付けて呼び出すコールバックメソッドになります。次に例を示します。" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -780,7 +798,7 @@ " ]]>" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -801,19 +819,19 @@ "<literal>customer</literal> タイプをインポートする必要があります。" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customer\"/>]]>" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "クライアントのインタフェース" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -826,7 +844,7 @@ "ポートするか、 <literal>s:remote</literal> を使用してインポートします。" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -838,13 +856,13 @@ "script>]]>" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "<![CDATA[<s:remote include=\"customerAction\"/>]]>" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -858,7 +876,7 @@ "になります。" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -873,7 +891,7 @@ "メータとして渡すまたは結果として返すことができるタイプを表します。" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -897,13 +915,13 @@ "うになります。" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "コンテキスト" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -915,13 +933,13 @@ "が、将来拡張される可能性があります。" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "対話 ID の設定と読み込み" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -939,7 +957,7 @@ "出します。" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -957,13 +975,13 @@ "対話だけを使用する場合は、特別なことをする必要はありません。" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "現在の対話スコープ内のリモート呼び出し" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -978,7 +996,7 @@ "される対話 ID が現在のビューの対話 ID にセットされます。" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -988,13 +1006,13 @@ "id} );]]>" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "バッチ要求" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -1006,7 +1024,7 @@ "どこでもこの特徴を使用することを推奨します。" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -1029,7 +1047,7 @@ "定されていれば) 実行と同じ順番で起動されます。" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -1042,7 +1060,7 @@ "キュー待ちしているすべての呼び出しを破棄してそのバッチモードを終了します。" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -1052,19 +1070,19 @@ "chatroom</literal>を参照ください。" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "データタイプの取り扱い" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "プリミティブ型 / 基本タイプ" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -1076,13 +1094,13 @@ "性があります。" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "String 型" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." @@ -1091,13 +1109,13 @@ "使用してください。" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "Number 型" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -1116,13 +1134,13 @@ "<literal>Short</literal> の各タイプに対してサポートされます。" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "Boolean 型" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -1132,13 +1150,13 @@ "サイドでは Java boolean で表現されます。" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "JavaBeans" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -1154,7 +1172,7 @@ "Remoting.createType()</literal>)。" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -1170,7 +1188,7 @@ "メソッドがあるかもしれません。" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -1188,7 +1206,7 @@ "}" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -1204,13 +1222,13 @@ "があります。" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -1222,13 +1240,13 @@ "<literal>myAction.doSomethingWithObject()</literal> に渡されます。" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "日付と時刻" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -1244,13 +1262,13 @@ "どの下位クラス)。" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "Enum" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -1262,7 +1280,7 @@ "として参照してください。" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -1284,7 +1302,7 @@ "}" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -1294,13 +1312,13 @@ "出すには、 String のままでパラメータ値を渡します。" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -1312,19 +1330,19 @@ "む場合)、クライアント側では String として表示されます。" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "集合" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "Bag" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1346,13 +1364,13 @@ "プに変換することが可能です。" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "Map" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1366,13 +1384,13 @@ "Remoting.Map</literal> オブジェクトを作成します。" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "var map = new Seam.Remoting.Map();" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1395,13 +1413,13 @@ "トを含む Javascript Array オブジェクトが返されます。" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "デバッグ機能" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1416,25 +1434,25 @@ "りです。" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "Seam.Remoting.setDebug(true);" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "components.xml を使って設定を行う方法は次のようになります。" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1446,13 +1464,13 @@ "Remoting.log(message)</literal> を呼び出します。" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1463,7 +1481,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1482,7 +1500,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1492,7 +1510,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1502,13 +1520,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "メッセージをロードする" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1519,13 +1537,13 @@ "ダリングのカスタマイズ、完全にオフにするなどが可能です。" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "メッセージを変更する" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1535,19 +1553,19 @@ "は、 <literal>Seam.Remoting.loadingMessage</literal> の値を設定します。" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "Seam.Remoting.loadingMessage = \"Loading...\";" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "ローディングメッセージを隠す" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1560,7 +1578,7 @@ "()</literal> を何も行わない機能で上書きします。" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1572,13 +1590,13 @@ "Seam.Remoting.hideLoadingMessage = function() {};" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "カスタムのローディングインジケータ" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1592,7 +1610,7 @@ "てこれを行います。" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1612,13 +1630,13 @@ " };" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "戻り値の制御" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1644,7 +1662,7 @@ "密情報が公開されてしまうのを防ぎたい場合もあるかもしれません。" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1663,7 +1681,7 @@ "ます。" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1671,7 +1689,7 @@ msgstr "すべての例で次の <literal>Widget</literal> クラスを使用します。" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1699,13 +1717,13 @@ "}" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "フィールドの制約" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1717,7 +1735,7 @@ "ない場合、次のように制約します。" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1727,7 +1745,7 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1748,7 +1766,7 @@ "ブジェクトグラフ内のこのフィールドのパスを指定することができます。" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1758,13 +1776,13 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "Map とコレクションの制約" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1786,7 +1804,7 @@ "ションは次のようになります。" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1796,7 +1814,7 @@ "public Widget getWidget();" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1815,7 +1833,7 @@ "literal> フィールドを持たせる方法を示しています。" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1825,13 +1843,13 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "特定タイプのオブジェクトを制約する" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1847,7 +1865,7 @@ "し角括弧を使って表現されます。" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1857,13 +1875,13 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "制約同士を組み合わせる" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1873,7 +1891,7 @@ "に組み合わせることもできます。" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1883,13 +1901,13 @@ "public Widget getWidget();" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, fuzzy, no-c-format msgid "Transactional Requests" msgstr "バッチ要求" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1899,7 +1917,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1909,13 +1927,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "JMS メッセージング" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1929,7 +1947,7 @@ "稼働環境下で使用することは推奨されていません。" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1946,26 +1964,26 @@ "ます。" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "JMS Topic のサブスクライブ" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "次の例では JMS Topic へのサブスクライブ方法を示しています。" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1985,7 +2003,7 @@ "Seam.Remoting.subscribe(\"topicName\", subscriptionCallback);" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1997,7 +2015,7 @@ "が受け取られると呼び出すコールバック機能になります。" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -2023,13 +2041,13 @@ "を呼び出す)。" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "トピックのサブスクライブを中止する" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -2039,20 +2057,20 @@ "</literal> を呼び出してトピック名で渡します。" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "Seam.Remoting.unsubscribe(\"topicName\");" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "ポーリングのプロセスの調整" # <literal>Seam.Remoting.pollInterval</literal>: en.xml:759 (para) #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -2066,7 +2084,7 @@ "定は 10 になります。" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -2083,7 +2101,7 @@ "返されます。" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -2099,7 +2117,7 @@ "果になります。" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -2113,19 +2131,19 @@ "用のアプリケーションに適切な値を設定してください。" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "components.xml:" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "JavaScript:" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:29+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Dependencies.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Drools.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Events.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Excel.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Feedback.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Framework.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Glassfish.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Groovy.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Guice.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Gwt.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Hsearch.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/I18n.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Itext.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Jbpm.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Jms.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Mail.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Performance.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Persistence.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE 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-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Preface.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Remoting.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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" @@ -34,7 +34,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -208,19 +208,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -228,14 +246,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -243,7 +261,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -264,7 +282,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -275,7 +293,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -286,14 +304,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -304,7 +322,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -320,7 +338,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -329,13 +347,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -348,13 +366,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -364,7 +382,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -402,25 +420,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -429,13 +447,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -446,7 +464,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -456,19 +474,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -476,7 +494,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -486,13 +504,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -502,13 +520,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -519,19 +537,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -541,13 +559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -560,7 +578,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -574,7 +592,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -588,19 +606,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -610,7 +628,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -619,13 +637,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -635,7 +653,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -646,7 +664,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -661,13 +679,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -676,13 +694,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -694,7 +712,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -707,13 +725,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -724,7 +742,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -732,13 +750,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -747,7 +765,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -762,7 +780,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -772,7 +790,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -780,19 +798,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -801,26 +819,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -833,13 +851,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -847,13 +865,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -864,7 +882,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -875,7 +893,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -887,7 +905,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -898,13 +916,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -913,13 +931,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -930,13 +948,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -945,7 +963,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -959,7 +977,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -967,13 +985,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -982,19 +1000,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1008,13 +1026,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1024,13 +1042,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1045,13 +1063,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1061,25 +1079,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1088,13 +1106,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1105,7 +1123,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1116,7 +1134,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1124,7 +1142,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1134,7 +1152,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1144,13 +1162,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1159,13 +1177,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1173,19 +1191,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1195,7 +1213,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1204,13 +1222,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1220,7 +1238,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1233,13 +1251,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1255,7 +1273,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1267,7 +1285,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1275,7 +1293,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1292,13 +1310,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1307,7 +1325,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1315,7 +1333,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1329,7 +1347,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1337,13 +1355,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1357,7 +1375,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1365,7 +1383,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1378,7 +1396,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1386,13 +1404,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1403,7 +1421,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1411,13 +1429,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1425,7 +1443,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1433,13 +1451,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1449,7 +1467,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1459,13 +1477,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1475,7 +1493,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1486,25 +1504,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1517,7 +1535,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1526,7 +1544,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1542,13 +1560,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1556,19 +1574,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1578,7 +1596,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1590,7 +1608,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1601,7 +1619,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1611,19 +1629,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Rss.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Security.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Spring.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Testing.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Text.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Tools.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Tutorial.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Validation.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Weblogic.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Webservices.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Websphere.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Wicket.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pot/Xml.pot =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot 2009-05-23 11:40:36 UTC (rev 10944) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-05-16 19:19+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+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_1/doc/Seam_Reference_Guide/pt-BR/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-21 00:37+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next " Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Remoting.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Remoting.po 2009-05-23 11:03:23 UTC (rev 10943) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Remoting.po 2009-05-23 11:40:36 UTC (rev 10944) @@ -5,7 +5,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-03-17 20:35+0000\n" +"POT-Creation-Date: 2009-05-23 11:30+0000\n" "PO-Revision-Date: 2008-04-04 01:24+0000\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -33,7 +33,7 @@ msgstr "" #. Tag: title -#: Remoting.xml:13 Remoting.xml:599 +#: Remoting.xml:13 Remoting.xml:608 #, no-c-format msgid "Configuration" msgstr "" @@ -207,19 +207,37 @@ #. Tag: para #: Remoting.xml:69 #, no-c-format +msgid "That's all the server-side code we need to write." +msgstr "" + +#. Tag: para +#: Remoting.xml:72 +#, no-c-format msgid "" -"That's all the server-side code we need to write. Now for our web page - " -"create a new page and import the <literal>helloAction</literal> component:" +"If you are performing a persistence operation in the method marked " +"<literal>@WebRemote</literal> you will also need to add a " +"<literal>@Transactional</literal> annotation to the method. Otherwise, your " +"method would execute outside of a transaction without this extra hint.That's " +"because unlike a JSF request, Seam does not wrap the remoting request in a " +"transaction automatically." msgstr "" +#. Tag: para +#: Remoting.xml:78 +#, no-c-format +msgid "" +"Now for our web page - create a new page and import the " +"<literal>helloAction</literal> component:" +msgstr "" + #. Tag: programlisting -#: Remoting.xml:72 +#: Remoting.xml:81 #, no-c-format msgid "<![CDATA[<s:remote include=\"helloAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:74 +#: Remoting.xml:83 #, no-c-format msgid "" "To make this a fully interactive user experience, let's add a button to our " @@ -227,14 +245,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:76 +#: Remoting.xml:85 #, no-c-format msgid "" "<![CDATA[<button onclick=\"javascript:sayHello()\">Say Hello</button>]]>" msgstr "" #. Tag: para -#: Remoting.xml:78 +#: Remoting.xml:87 #, no-c-format msgid "" "We'll also need to add some more script to make our button actually do " @@ -242,7 +260,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:80 +#: Remoting.xml:89 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\">\n" @@ -263,7 +281,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:82 +#: Remoting.xml:91 #, no-c-format msgid "" "We're done! Deploy your application and browse to your page. Click the " @@ -274,7 +292,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:87 +#: Remoting.xml:96 #, no-c-format msgid "" "So what does the code of our script actually do? Let's break it down into " @@ -285,14 +303,14 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:92 +#: Remoting.xml:101 #, no-c-format msgid "" "Seam.Component.getInstance(\"helloAction\").sayHello(name, sayHelloCallback);" msgstr "" #. Tag: para -#: Remoting.xml:94 +#: Remoting.xml:103 #, no-c-format msgid "" "The first section of this line, <literal>Seam.Component.getInstance" @@ -303,7 +321,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:99 +#: Remoting.xml:108 #, no-c-format msgid "" "What this line of code in its completeness does, is invoke the " @@ -319,7 +337,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:107 +#: Remoting.xml:116 #, no-c-format msgid "" "The <literal>sayHelloCallback</literal> method, once receiving the response " @@ -328,13 +346,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:113 +#: Remoting.xml:122 #, no-c-format msgid "Seam.Component" msgstr "" #. Tag: para -#: Remoting.xml:115 +#: Remoting.xml:124 #, no-c-format msgid "" "The <literal>Seam.Component</literal> Javascript object provides a number of " @@ -347,13 +365,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:122 +#: Remoting.xml:131 #, no-c-format msgid "Seam.Component.newInstance()" msgstr "" #. Tag: para -#: Remoting.xml:123 +#: Remoting.xml:132 #, no-c-format msgid "" "Use this method to create a new instance of an entity or Javabean component. " @@ -363,7 +381,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:127 +#: Remoting.xml:136 #, no-c-format msgid "" "@Name(\"customer\")\n" @@ -401,25 +419,25 @@ msgstr "" #. Tag: para -#: Remoting.xml:129 +#: Remoting.xml:138 #, no-c-format msgid "To create a client-side Customer you would write the following code:" msgstr "" #. Tag: programlisting -#: Remoting.xml:131 +#: Remoting.xml:140 #, no-c-format msgid "var customer = Seam.Component.newInstance(\"customer\");" msgstr "" #. Tag: para -#: Remoting.xml:133 +#: Remoting.xml:142 #, no-c-format msgid "Then from here you can set the fields of the customer object:" msgstr "" #. Tag: programlisting -#: Remoting.xml:135 +#: Remoting.xml:144 #, no-c-format msgid "" "customer.setFirstName(\"John\");\n" @@ -428,13 +446,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:140 +#: Remoting.xml:149 #, no-c-format msgid "Seam.Component.getInstance()" msgstr "" #. Tag: para -#: Remoting.xml:142 +#: Remoting.xml:151 #, no-c-format msgid "" "The <literal>getInstance()</literal> method is used to get a reference to a " @@ -445,7 +463,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:147 +#: Remoting.xml:156 #, no-c-format msgid "" "To continue our example from before, if we have created a new " @@ -455,19 +473,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:151 +#: Remoting.xml:160 #, no-c-format msgid "Seam.Component.getInstance(\"customerAction\").saveCustomer(customer);" msgstr "" #. Tag: title -#: Remoting.xml:155 +#: Remoting.xml:164 #, no-c-format msgid "Seam.Component.getComponentName()" msgstr "" #. Tag: para -#: Remoting.xml:157 +#: Remoting.xml:166 #, no-c-format msgid "" "Passing an object into this method will return its component name if it is a " @@ -475,7 +493,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:160 +#: Remoting.xml:169 #, no-c-format msgid "" "if (Seam.Component.getComponentName(instance) == \"customer\")\n" @@ -485,13 +503,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:166 +#: Remoting.xml:175 #, no-c-format msgid "Seam.Remoting" msgstr "" #. Tag: para -#: Remoting.xml:168 +#: Remoting.xml:177 #, no-c-format msgid "" "Most of the client side functionality for Seam Remoting is contained within " @@ -501,13 +519,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:173 +#: Remoting.xml:182 #, no-c-format msgid "Seam.Remoting.createType()" msgstr "" #. Tag: para -#: Remoting.xml:175 +#: Remoting.xml:184 #, no-c-format msgid "" "If your application contains or uses Javabean classes that aren't Seam " @@ -518,19 +536,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:180 +#: Remoting.xml:189 #, no-c-format msgid "var widget = Seam.Remoting.createType(\"com.acme.widgets.MyWidget\");" msgstr "" #. Tag: title -#: Remoting.xml:184 +#: Remoting.xml:193 #, no-c-format msgid "Seam.Remoting.getTypeName()" msgstr "" #. Tag: para -#: Remoting.xml:186 +#: Remoting.xml:195 #, no-c-format msgid "" "This method is the equivalent of <literal>Seam.Component.getComponentName()</" @@ -540,13 +558,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:194 +#: Remoting.xml:203 #, no-c-format msgid "Evaluating EL Expressions" msgstr "" #. Tag: para -#: Remoting.xml:196 +#: Remoting.xml:205 #, no-c-format msgid "" "Seam Remoting also supports the evaluation of EL expressions, which provides " @@ -559,7 +577,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:204 +#: Remoting.xml:213 #, no-c-format msgid "" "<![CDATA[ function customersCallback(customers) {\n" @@ -573,7 +591,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:206 +#: Remoting.xml:215 #, no-c-format msgid "" "In this example, the expression <literal>#{customers}</literal> is evaluated " @@ -587,19 +605,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:214 +#: Remoting.xml:223 #, no-c-format msgid "<![CDATA[<s:remote include=\"customer\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:218 +#: Remoting.xml:227 #, no-c-format msgid "Client Interfaces" msgstr "" #. Tag: para -#: Remoting.xml:220 +#: Remoting.xml:229 #, no-c-format msgid "" "In the configuration section above, the interface, or \"stub\" for our " @@ -609,7 +627,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:225 +#: Remoting.xml:234 #, no-c-format msgid "" "<![CDATA[<script type=\"text/javascript\" \n" @@ -618,13 +636,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:227 +#: Remoting.xml:236 #, no-c-format msgid "<![CDATA[<s:remote include=\"customerAction\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:229 +#: Remoting.xml:238 #, no-c-format msgid "" "By including this script in our page, the interface definitions for our " @@ -634,7 +652,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:233 +#: Remoting.xml:242 #, no-c-format msgid "" "There are two types of client stub that can be generated, \"executable\" " @@ -645,7 +663,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:237 +#: Remoting.xml:246 #, no-c-format msgid "" "The type of client stub that is generated depends on the type of your Seam " @@ -660,13 +678,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:247 +#: Remoting.xml:256 #, no-c-format msgid "The Context" msgstr "" #. Tag: para -#: Remoting.xml:249 +#: Remoting.xml:258 #, no-c-format msgid "" "The Seam Remoting Context contains additional information which is sent and " @@ -675,13 +693,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:253 +#: Remoting.xml:262 #, no-c-format msgid "Setting and reading the Conversation ID" msgstr "" #. Tag: para -#: Remoting.xml:256 +#: Remoting.xml:265 #, no-c-format msgid "" "If you intend on using remote calls within the scope of a conversation then " @@ -693,7 +711,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:261 +#: Remoting.xml:270 #, no-c-format msgid "" "If the conversation ID hasn't been explicitly set with <literal>Seam." @@ -706,13 +724,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:268 +#: Remoting.xml:277 #, no-c-format msgid "Remote calls within the current conversation scope" msgstr "" #. Tag: para -#: Remoting.xml:270 +#: Remoting.xml:279 #, no-c-format msgid "" "In some circumstances it may be required to make a remote call within the " @@ -723,7 +741,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:275 +#: Remoting.xml:284 #, no-c-format msgid "" "<![CDATA[Seam.Remoting.getContext().setConversationId( #{conversation." @@ -731,13 +749,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:280 +#: Remoting.xml:289 #, no-c-format msgid "Batch Requests" msgstr "" #. Tag: para -#: Remoting.xml:282 +#: Remoting.xml:291 #, no-c-format msgid "" "Seam Remoting allows multiple component calls to be executed within a single " @@ -746,7 +764,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:285 +#: Remoting.xml:294 #, no-c-format msgid "" "The method <literal>Seam.Remoting.startBatch()</literal> will start a new " @@ -761,7 +779,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:292 +#: Remoting.xml:301 #, no-c-format msgid "" "If you start a new batch via the <literal>startBatch()</literal> method but " @@ -771,7 +789,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:296 +#: Remoting.xml:305 #, no-c-format msgid "" "To see an example of a batch being used, take a look at <literal>/examples/" @@ -779,19 +797,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:301 +#: Remoting.xml:310 #, no-c-format msgid "Working with Data types" msgstr "" #. Tag: title -#: Remoting.xml:304 +#: Remoting.xml:313 #, no-c-format msgid "Primitives / Basic Types" msgstr "" #. Tag: para -#: Remoting.xml:306 +#: Remoting.xml:315 #, no-c-format msgid "" "This section describes the support for basic data types. On the server side " @@ -800,26 +818,26 @@ msgstr "" #. Tag: title -#: Remoting.xml:310 +#: Remoting.xml:319 #, no-c-format msgid "String" msgstr "" #. Tag: para -#: Remoting.xml:312 +#: Remoting.xml:321 #, no-c-format msgid "" "Simply use Javascript String objects when setting String parameter values." msgstr "" #. Tag: title -#: Remoting.xml:316 +#: Remoting.xml:325 #, no-c-format msgid "Number" msgstr "" #. Tag: para -#: Remoting.xml:318 +#: Remoting.xml:327 #, no-c-format msgid "" "There is support for all number types supported by Java. On the client side, " @@ -832,13 +850,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:326 +#: Remoting.xml:335 #, no-c-format msgid "Boolean" msgstr "" #. Tag: para -#: Remoting.xml:328 +#: Remoting.xml:337 #, no-c-format msgid "" "Booleans are represented client side by Javascript Boolean values, and " @@ -846,13 +864,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:334 +#: Remoting.xml:343 #, no-c-format msgid "JavaBeans" msgstr "" #. Tag: para -#: Remoting.xml:336 +#: Remoting.xml:345 #, no-c-format msgid "" "In general these will be either Seam entity or JavaBean components, or some " @@ -863,7 +881,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:340 +#: Remoting.xml:349 #, no-c-format msgid "" "It is important to note that only objects that are created by either of " @@ -874,7 +892,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:345 +#: Remoting.xml:354 #, no-c-format msgid "" "@Name(\"myAction\")\n" @@ -886,7 +904,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:347 +#: Remoting.xml:356 #, no-c-format msgid "" "In this case you might want to pass in an instance of your " @@ -897,13 +915,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:352 +#: Remoting.xml:361 #, no-c-format msgid "<![CDATA[<s:remote include=\"myAction,myWidget\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:354 +#: Remoting.xml:363 #, no-c-format msgid "" "This will then allow a <literal>myWidget</literal> object to be created with " @@ -912,13 +930,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:361 +#: Remoting.xml:370 #, no-c-format msgid "Dates and Times" msgstr "" #. Tag: para -#: Remoting.xml:363 +#: Remoting.xml:372 #, no-c-format msgid "" "Date values are serialized into a String representation that is accurate to " @@ -929,13 +947,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:370 +#: Remoting.xml:379 #, no-c-format msgid "Enums" msgstr "" #. Tag: para -#: Remoting.xml:372 +#: Remoting.xml:381 #, no-c-format msgid "" "On the client side, enums are treated the same as Strings. When setting the " @@ -944,7 +962,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:375 +#: Remoting.xml:384 #, no-c-format msgid "" "@Name(\"paintAction\")\n" @@ -958,7 +976,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:377 +#: Remoting.xml:386 #, no-c-format msgid "" "To call the <literal>paint()</literal> method with the color <literal>red</" @@ -966,13 +984,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:380 +#: Remoting.xml:389 #, no-c-format msgid "Seam.Component.getInstance(\"paintAction\").paint(\"red\");" msgstr "" #. Tag: para -#: Remoting.xml:382 +#: Remoting.xml:391 #, no-c-format msgid "" "The inverse is also true - that is, if a component method returns an enum " @@ -981,19 +999,19 @@ msgstr "" #. Tag: title -#: Remoting.xml:387 +#: Remoting.xml:396 #, no-c-format msgid "Collections" msgstr "" #. Tag: title -#: Remoting.xml:390 +#: Remoting.xml:399 #, no-c-format msgid "Bags" msgstr "" #. Tag: para -#: Remoting.xml:392 +#: Remoting.xml:401 #, no-c-format msgid "" "Bags cover all collection types including arrays, collections, lists, sets, " @@ -1007,13 +1025,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:401 +#: Remoting.xml:410 #, no-c-format msgid "Maps" msgstr "" #. Tag: para -#: Remoting.xml:403 +#: Remoting.xml:412 #, no-c-format msgid "" "As there is no native support for Maps within Javascript, a simple Map " @@ -1023,13 +1041,13 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:407 +#: Remoting.xml:416 #, no-c-format msgid "var map = new Seam.Remoting.Map();" msgstr "" #. Tag: para -#: Remoting.xml:409 +#: Remoting.xml:418 #, no-c-format msgid "" "This Javascript implementation provides basic methods for working with Maps: " @@ -1044,13 +1062,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:420 +#: Remoting.xml:429 #, no-c-format msgid "Debugging" msgstr "" #. Tag: para -#: Remoting.xml:422 +#: Remoting.xml:431 #, no-c-format msgid "" "To aid in tracking down bugs, it is possible to enable a debug mode which " @@ -1060,25 +1078,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:426 +#: Remoting.xml:435 #, no-c-format msgid "Seam.Remoting.setDebug(true);" msgstr "" #. Tag: para -#: Remoting.xml:428 +#: Remoting.xml:437 #, no-c-format msgid "Or configure it via components.xml:" msgstr "" #. Tag: programlisting -#: Remoting.xml:430 +#: Remoting.xml:439 #, no-c-format msgid "<![CDATA[<remoting:remoting debug=\"true\"/>]]>" msgstr "" #. Tag: para -#: Remoting.xml:432 +#: Remoting.xml:441 #, no-c-format msgid "" "To turn off debugging, call <literal>setDebug(false)</literal>. If you want " @@ -1087,13 +1105,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:437 +#: Remoting.xml:446 #, no-c-format msgid "Handling Exceptions" msgstr "" #. Tag: para -#: Remoting.xml:439 +#: Remoting.xml:448 #, no-c-format msgid "" "When invoking a remote component method, it is possible to specify an " @@ -1104,7 +1122,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:445 +#: Remoting.xml:454 #, no-c-format msgid "" "<![CDATA[var callback = function(result) { alert(result); };\n" @@ -1115,7 +1133,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:447 +#: Remoting.xml:456 #, no-c-format msgid "" "If you do not have a callback handler defined, you must specify " @@ -1123,7 +1141,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:451 +#: Remoting.xml:460 #, no-c-format msgid "" "<![CDATA[var exceptionHandler = function(ex) { alert(\"An exception " @@ -1133,7 +1151,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:453 +#: Remoting.xml:462 #, no-c-format msgid "" "The exception object that is passed to the exception handler exposes one " @@ -1143,13 +1161,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:462 +#: Remoting.xml:471 #, no-c-format msgid "The Loading Message" msgstr "" #. Tag: para -#: Remoting.xml:464 +#: Remoting.xml:473 #, no-c-format msgid "" "The default loading message that appears in the top right corner of the " @@ -1158,13 +1176,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:468 +#: Remoting.xml:477 #, no-c-format msgid "Changing the message" msgstr "" #. Tag: para -#: Remoting.xml:470 +#: Remoting.xml:479 #, no-c-format msgid "" "To change the message from the default \"Please Wait...\" to something " @@ -1172,19 +1190,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:473 +#: Remoting.xml:482 #, no-c-format msgid "Seam.Remoting.loadingMessage = \"Loading...\";" msgstr "" #. Tag: title -#: Remoting.xml:477 +#: Remoting.xml:486 #, no-c-format msgid "Hiding the loading message" msgstr "" #. Tag: para -#: Remoting.xml:479 +#: Remoting.xml:488 #, no-c-format msgid "" "To completely suppress the display of the loading message, override the " @@ -1194,7 +1212,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:483 +#: Remoting.xml:492 #, no-c-format msgid "" "// don't display the loading indicator\n" @@ -1203,13 +1221,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:487 +#: Remoting.xml:496 #, no-c-format msgid "A Custom Loading Indicator" msgstr "" #. Tag: para -#: Remoting.xml:489 +#: Remoting.xml:498 #, no-c-format msgid "" "It is also possible to override the loading indicator to display an animated " @@ -1219,7 +1237,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:493 +#: Remoting.xml:502 #, no-c-format msgid "" "Seam.Remoting.displayLoadingMessage = function() {\n" @@ -1232,13 +1250,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:498 +#: Remoting.xml:507 #, no-c-format msgid "Controlling what data is returned" msgstr "" #. Tag: para -#: Remoting.xml:500 +#: Remoting.xml:509 #, no-c-format msgid "" "When a remote method is executed, the result is serialized into an XML " @@ -1254,7 +1272,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:508 +#: Remoting.xml:517 #, no-c-format msgid "" "Seam Remoting provides a simple means to \"constrain\" the object graph, by " @@ -1266,7 +1284,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:513 +#: Remoting.xml:522 #, no-c-format msgid "" "For all our examples, we'll use the following <literal>Widget</literal> " @@ -1274,7 +1292,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:515 +#: Remoting.xml:524 #, no-c-format msgid "" "@Name(\"widget\")\n" @@ -1291,13 +1309,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:518 +#: Remoting.xml:527 #, no-c-format msgid "Constraining normal fields" msgstr "" #. Tag: para -#: Remoting.xml:520 +#: Remoting.xml:529 #, no-c-format msgid "" "If your remote method returns an instance of <literal>Widget</literal>, but " @@ -1306,7 +1324,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:523 +#: Remoting.xml:532 #, no-c-format msgid "" "@WebRemote(exclude = {\"secret\"})\n" @@ -1314,7 +1332,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:525 +#: Remoting.xml:534 #, no-c-format msgid "" "The value \"secret\" refers to the <literal>secret</literal> field of the " @@ -1328,7 +1346,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:532 +#: Remoting.xml:541 #, no-c-format msgid "" "@WebRemote(exclude = {\"child.secret\"})\n" @@ -1336,13 +1354,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:537 +#: Remoting.xml:546 #, no-c-format msgid "Constraining Maps and Collections" msgstr "" #. Tag: para -#: Remoting.xml:539 +#: Remoting.xml:548 #, no-c-format msgid "" "The other place that objects can exist within an object graph are within a " @@ -1356,7 +1374,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:546 +#: Remoting.xml:555 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\"})\n" @@ -1364,7 +1382,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:548 +#: Remoting.xml:557 #, no-c-format msgid "" "To constrain a <literal>Map</literal>'s key or value, the notation is " @@ -1377,7 +1395,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:554 +#: Remoting.xml:563 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetMap[value].secret\"})\n" @@ -1385,13 +1403,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:558 +#: Remoting.xml:567 #, no-c-format msgid "Constraining objects of a specific type" msgstr "" #. Tag: para -#: Remoting.xml:560 +#: Remoting.xml:569 #, no-c-format msgid "" "There is one last notation that can be used to constrain the fields of a " @@ -1402,7 +1420,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:565 +#: Remoting.xml:574 #, no-c-format msgid "" "@WebRemote(exclude = {\"[widget].secret\"})\n" @@ -1410,13 +1428,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:570 +#: Remoting.xml:579 #, no-c-format msgid "Combining Constraints" msgstr "" #. Tag: para -#: Remoting.xml:572 +#: Remoting.xml:581 #, no-c-format msgid "" "Constraints can also be combined, to filter objects from multiple paths " @@ -1424,7 +1442,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:574 +#: Remoting.xml:583 #, no-c-format msgid "" "@WebRemote(exclude = {\"widgetList.secret\", \"widgetMap[value].secret\"})\n" @@ -1432,13 +1450,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:580 +#: Remoting.xml:589 #, no-c-format msgid "Transactional Requests" msgstr "" #. Tag: para -#: Remoting.xml:582 +#: Remoting.xml:591 #, no-c-format msgid "" "By default there is no active transaction during a remoting request, so if " @@ -1448,7 +1466,7 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:588 +#: Remoting.xml:597 #, no-c-format msgid "" "<![CDATA[ @WebRemote @Transactional(TransactionPropagationType.REQUIRED)\n" @@ -1458,13 +1476,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:592 +#: Remoting.xml:601 #, no-c-format msgid "JMS Messaging" msgstr "" #. Tag: para -#: Remoting.xml:594 +#: Remoting.xml:603 #, no-c-format msgid "" "Seam Remoting provides experimental support for JMS Messaging. This section " @@ -1474,7 +1492,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:601 +#: Remoting.xml:610 #, no-c-format msgid "" "Before you can subscribe to a JMS topic, you must first configure a list of " @@ -1485,25 +1503,25 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:606 Remoting.xml:661 +#: Remoting.xml:615 Remoting.xml:670 #, no-c-format msgid "<![CDATA[<remoting:remoting poll-timeout=\"5\" poll-interval=\"1\"/>]]>" msgstr "" #. Tag: title -#: Remoting.xml:611 +#: Remoting.xml:620 #, no-c-format msgid "Subscribing to a JMS Topic" msgstr "" #. Tag: para -#: Remoting.xml:613 +#: Remoting.xml:622 #, no-c-format msgid "The following example demonstrates how to subscribe to a JMS Topic:" msgstr "" #. Tag: programlisting -#: Remoting.xml:615 +#: Remoting.xml:624 #, no-c-format msgid "" "function subscriptionCallback(message)\n" @@ -1516,7 +1534,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:617 +#: Remoting.xml:626 #, no-c-format msgid "" "The <literal>Seam.Remoting.subscribe()</literal> method accepts two " @@ -1525,7 +1543,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:620 +#: Remoting.xml:629 #, no-c-format msgid "" "There are two types of messages supported, Text messages and Object " @@ -1541,13 +1559,13 @@ msgstr "" #. Tag: title -#: Remoting.xml:630 +#: Remoting.xml:639 #, no-c-format msgid "Unsubscribing from a Topic" msgstr "" #. Tag: para -#: Remoting.xml:632 +#: Remoting.xml:641 #, no-c-format msgid "" "To unsubscribe from a topic, call <literal>Seam.Remoting.unsubscribe()</" @@ -1555,19 +1573,19 @@ msgstr "" #. Tag: programlisting -#: Remoting.xml:635 +#: Remoting.xml:644 #, no-c-format msgid "Seam.Remoting.unsubscribe(\"topicName\");" msgstr "" #. Tag: title -#: Remoting.xml:639 +#: Remoting.xml:648 #, no-c-format msgid "Tuning the Polling Process" msgstr "" #. Tag: para -#: Remoting.xml:641 +#: Remoting.xml:650 #, no-c-format msgid "" "There are two parameters which you can modify to control how polling occurs. " @@ -1577,7 +1595,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:645 +#: Remoting.xml:654 #, no-c-format msgid "" "The second parameter is <literal>Seam.Remoting.pollTimeout</literal>, and is " @@ -1589,7 +1607,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:650 +#: Remoting.xml:659 #, no-c-format msgid "" "Caution should be used when setting a high <literal>pollTimeout</literal> " @@ -1600,7 +1618,7 @@ msgstr "" #. Tag: para -#: Remoting.xml:655 +#: Remoting.xml:664 #, no-c-format msgid "" "It is recommended that you set these options via components.xml, however " @@ -1610,19 +1628,19 @@ msgstr "" #. Tag: para -#: Remoting.xml:659 +#: Remoting.xml:668 #, no-c-format msgid "Via components.xml:" msgstr "" #. Tag: para -#: Remoting.xml:663 +#: Remoting.xml:672 #, no-c-format msgid "Via JavaScript:" msgstr "" #. Tag: programlisting -#: Remoting.xml:665 +#: Remoting.xml:674 #, no-c-format msgid "" "// Only wait 1 second between receiving a poll response and sending the next "

16 years, 11 months

1
0
0 / 0

Seam SVN: r10943 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: milesif Date: 2009-05-23 07:03:23 -0400 (Sat, 23 May 2009) New Revision: 10943 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Persistence.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Persistence.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Persistence.po 2009-05-23 10:51:46 UTC (rev 10942) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Persistence.po 2009-05-23 11:03:23 UTC (rev 10943) @@ -6,8 +6,8 @@ "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" "POT-Creation-Date: 2009-02-19 21:44+0000\n" -"PO-Revision-Date: 2009-02-22 10:52+0100\n" -"Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" +"PO-Revision-Date: 2009-05-21 15:36+0100\n" +"Last-Translator: Francesco Milesi <milesif(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -107,37 +107,37 @@ #: Persistence.xml:116 #, no-c-format msgid "Hibernate users developed the <emphasis>\"open session in view\"</emphasis> pattern to work around this problem. In the Hibernate community, \"open session in view\" was historically even more important because frameworks like Spring use transaction-scoped persistence contexts. So rendering the view would cause <literal>LazyInitializationException</literal>s when unfetched associations were accessed." -msgstr "" +msgstr "Gli utenti di Hibernate hanno sviluppato il pattern <emphasis>\"open session in view\"</emphasis> per aggirare questo problema. Nella comunità Hibernate, il pattern \"open session in view\" è stato storicamente anche più importante poiché framework come Spring usano contesti di persistenza con scope transazionale. In tal caso il rendering della vista causerebbe eccezioni di tipo <literal>LazyInitializationException</literal>, qualora si accedesse a delle relazioni non caricate in precedenza." #. Tag: para #: Persistence.xml:124 #, no-c-format msgid "This pattern is usually implemented as a single transaction which spans the entire request. There are several problems with this implementation, the most serious being that we can never be sure that a transaction is successful until we commit it — but by the time the \"open session in view\" transaction is committed, the view is fully rendered, and the rendered response may already have been flushed to the client. How can we notify the user that their transaction was unsuccessful?" -msgstr "" +msgstr "Questo pattern di solito è implementato come una singola transazione che si estende per l'intera richiesta. Vi sono parecchi problemi connessi a questa implementaziome, il più serio dei quali sta nel fatto che non è possibile essere sicuri che una transazione sia andata a buon fine finché non se ne fa il commit — ma prima che la transazione gestita secondo tale pattern sia stata sottoposta a commit, la pagina sarà stata completamente disegnata, e la risposta relativa potrebbe essere già stata inviata al client. Come è possibile notificare l'utente che la sua transazione non ha avuto successo?" #. Tag: para #: Persistence.xml:133 #, no-c-format msgid "Seam solves both the transaction isolation problem and the association fetching problem, while working around the problems with \"open session in view\". The solution comes in two parts:" -msgstr "" +msgstr "Seam risolve sia il problema dell'isolamento della transazione sia il problema del caricamento delle associazioni, evitando i quelli associati al pattern \"open session in view\". La soluzione è costituita da due parti:" #. Tag: para #: Persistence.xml:141 #, no-c-format msgid "use an extended persistence context that is scoped to the conversation, instead of to the transaction" -msgstr "" +msgstr "occorre utilizzare un contesto di persistenza esteso con scope conversazionale, invece che transazionale" #. Tag: para #: Persistence.xml:147 #, no-c-format msgid "use two transactions per request; the first spans the beginning of the restore view phase (some transaction managers begin the transaction later at the beginning of the apply request vaues phase) until the end of the invoke application phase; the second spans the render response phase" -msgstr "" +msgstr "occorre usare due transazione per richiesta; la prima si estende dall'inizio della fase di ripristino della vista, o \"restore view phase\", (qualche transaction manager inizia la transazione più tardi, all'inizio della fase di applicazione dei valori della richiesta, o \"apply request values phase\") alla fine della fase di chiamata all'applicazione, o \"invoke application phase\"; la seconda copre la fase di rendering della risposta, o \"render response phase\"" #. Tag: para #: Persistence.xml:156 #, no-c-format msgid "In the next section, we'll tell you how to set up a conversation-scope persistence context. But first we need to tell you how to enable Seam transaction management. Note that you can use conversation-scoped persistence contexts without Seam transaction management, and there are good reasons to use Seam transaction management even when you're not using Seam-managed persistence contexts. However, the two facilities were designed to work together, and work best when used together." -msgstr "" +msgstr "Nella prossima sezione, esamineremo come utilizzare un contesto di persistenza conversazionale. Ma prima occorre vedere come abilitare la gestione delle transazioni di Seam. Si noti che è possibile usare contesti di persistenza conversazionale senza usare la gestione delle transazioni di Seam, e ci sono buoni motivi per utilizzare la gestione delle transazioni di Seam anche se non si stanno utilizzando contesti di persistenza gestiti da Seam. Comunque, queste due funzionalità sono state progettate per operare assieme, e usate assieme danno il meglio." #. Tag: para #: Persistence.xml:165 @@ -155,7 +155,7 @@ #: Persistence.xml:175 #, no-c-format msgid "Seam transaction management is enabled by default for all JSF requests. If you want to <emphasis>disable</emphasis> this feature, you can do it in <literal>components.xml</literal>:" -msgstr "" +msgstr "La gestione delle tarnsazioni di Seam è abilitato di default per tutte le richieste JSF. Se si desidera <emphasis>disabilitare</emphasis> questa funzionalità, è possibile farlo in <literal>components.xml</literal>:" #. Tag: programlisting #: Persistence.xml:181 @@ -179,7 +179,7 @@ #: Persistence.xml:188 #, no-c-format msgid "Seam provides a transaction management abstraction for beginning, committing, rolling back, and synchronizing with a transaction. By default Seam uses a JTA transaction component that integrates with Container Managed and programmatic EJB transactions. If you are working in a Java EE 5 environment, you should install the EJB synchronization component in <literal>components.xml</literal>:" -msgstr "" +msgstr "Seam fornisce un'astrazione della gestione della transazione che permette di iniziarla, farne il commit e il rollback e di sincronizzarsi con essa. Di default Seam usa un componente transazionale JTA che si integra con transazioni EJB gestite dal programma o dal container. Se si sta lavorando in un ambiente Java EE 5, occorre installare il componente di sincronizzazione EJB in <literal>components.xml</literal>:" #. Tag: programlisting #: Persistence.xml:195 @@ -191,31 +191,31 @@ #: Persistence.xml:197 #, no-c-format msgid "However, if you are working in a non EE 5 container, Seam will try auto detect the transaction synchronization mechanism to use. However, if Seam is unable to detect the correct transaction synchronization to use, you may find you need configure one of the following:" -msgstr "" +msgstr "Comunque, se si sta lavorando in un container non conforme a J2EE 5, Seam cercherà di rilevare automaticamente il meccanismo di sincronizzazione da usare. Comunque, qualora Seam non fosse in grado di rilevarlo, potrebbe essere necessario configurare una delle seguenti proprietà:" #. Tag: para #: Persistence.xml:204 #, no-c-format msgid "JPA RESOURCE_LOCAL transactions with the <literal>javax.persistence.EntityTransaction</literal> interface. <literal>EntityTransaction</literal> begins the transaction at the beginning of the apply request values phase." -msgstr "" +msgstr "Transazioni JPA di tipo RESOURCE_LOCAL con interfaccia <literal>javax.persistence.EntityTransaction</literal>. <literal>EntityTransaction</literal> inizia la transazione all'inizio della fase \"apply request values\"." #. Tag: para #: Persistence.xml:212 #, no-c-format msgid "Hibernate managed transactions with the <literal>org.hibernate.Transaction</literal> interface. <literal>HibernateTransaction</literal> begins the transaction at the beginning of the apply request values phase." -msgstr "" +msgstr "Transazioni gestite da Hibernate con l'interfaccia <literal>org.hibernate.Transaction</literal>. <literal>HibernateTransaction</literal> da inizio alla transazione all'inizio della fase \"apply request values\"." #. Tag: para #: Persistence.xml:220 #, no-c-format msgid "Spring managed transactions with the <literal>org.springframework.transaction.PlatformTransactionManager</literal> interface. The Spring <literal>PlatformTransactionManagement</literal> manager may begin the transaction at the beginning of the apply request values phase if the <literal>userConversationContext</literal> attribute is set." -msgstr "" +msgstr "Transazioni gestite da Spring con l'interfaccia <literal>org.springframework.transaction.PlatformTransactionManager</literal>. Il gestore <literal>PlatformTransactionManagement</literal> di Spring può cominciare la transazione all'inizio della fase \"apply request values\" se è stato valorizzato l'attributo <literal>userConversationContext</literal>." #. Tag: para #: Persistence.xml:229 #, no-c-format msgid "Explicitly disable Seam managed transactions" -msgstr "" +msgstr "Disabilitare esplicitamente le transazioni gestite da Seam" #. Tag: para #: Persistence.xml:234 @@ -569,7 +569,7 @@ #: Persistence.xml:471 #, no-c-format msgid "But regardless of whether you're using Hibernate (genius!) or something else (masochist, or just not very bright), you'll almost certainly want to use the delegate in your Seam components from time to time. One approach would be the following:" -msgstr "" +msgstr "Ma indipendentemente dal fatto che si stia usando Hibernate (se siete dei geni!) o altro (se siete dei masochisti, o semplicemente non siete troppo svegli), quasi sicuramente, di quando in quando, nei componenti Seam si vorrà usare il delegato. Un approccio potrebbe essere il seguente:" #. Tag: programlisting #: Persistence.xml:478 @@ -593,7 +593,7 @@ #: Persistence.xml:480 #, no-c-format msgid "But typecasts are unquestionably the ugliest syntax in the Java language, so most people avoid them whenever possible. Here's a different way to get at the delegate. First, add the following line to <literal>components.xml</literal>:" -msgstr "" +msgstr "Tuttavia i cast fra tipi sono senza discussione la sintassi più repellente del linguaggio java, così che la maggior parte della gente li evita quando possibile. Ecco un modo diverso per ottenere il delegato. Innanzitutto si aggiunga la linea seguente in <literal>components.xml</literal>:" #. Tag: programlisting #: Persistence.xml:486 @@ -643,7 +643,7 @@ #: Persistence.xml:498 #, no-c-format msgid "Seam proxies the <literal>EntityManager</literal> or <literal>Session</literal> object whenever you use a Seam-managed persistence context or inject a container managed persistence context using <literal>@PersistenceContext</literal>. This lets you use EL expressions in your query strings, safely and efficiently. For example, this:" -msgstr "" +msgstr "Seam fa da proxy all'oggetto <literal>EntityManager</literal> o all'oggetto <literal>Session</literal> ogni volta che si utilizza un contesto di persistenza gestito da Seam o si inietta un contesto di persistenza gestito dal container usando <literal>@PersistenceContext</literal>. Ciò permette di utilizzare le espressioni EL nelle stringhe delle query, in modo sicuro ed efficiente. Per esempio:" #. Tag: programlisting #: Persistence.xml:506 @@ -705,7 +705,7 @@ #: Persistence.xml:527 #, no-c-format msgid "The coolest, and most unique, feature of Hibernate is <emphasis>filters</emphasis>. Filters let you provide a restricted view of the data in the database. You can find out more about filters in the Hibernate documentation. But we thought we'd mention an easy way to incorporate filters into a Seam application, one that works especially well with the Seam Application Framework." -msgstr "" +msgstr "La funzionalità più bella e unica di Hibernate sono i <emphasis>filtri</emphasis>. I filtri permettono di fornire una vista ristretta dei dati esistenti nel database. E' possibile scoprire di più riguardo ai filtri nella documentazione di Hibernate. Abbiamo tuttavia pensato di menzionare un modo facile di incorporare i filtri in un'applicazione Seam, un modo che funziona particolarmente bene con il \"Seam Application Framework\"." #. Tag: para #: Persistence.xml:535

16 years, 11 months

1
0
0 / 0

Seam SVN: r10942 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-23 06:51:46 -0400 (Sat, 23 May 2009) New Revision: 10942 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po 2009-05-22 22:10:49 UTC (rev 10941) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Configuration.po 2009-05-23 10:51:46 UTC (rev 10942) @@ -6,7 +6,7 @@ "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" "POT-Creation-Date: 2009-05-05 12:31+0000\n" -"PO-Revision-Date: 2009-05-21 20:44+0100\n" +"PO-Revision-Date: 2009-05-23 12:48+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -648,7 +648,7 @@ #: Configuration.xml:350 #, no-c-format msgid "We need to apply the <literal>SeamInterceptor</literal> to our Seam EJB components. This interceptor delegates to a set of built-in server-side interceptors that handle such concerns as bijection, conversation demarcation, and business process signals. The simplest way to do this across an entire application is to add the following interceptor configuration in <literal>ejb-jar.xml</literal>:" -msgstr "" +msgstr "Occorre applicare <literal>SeamInterceptor</literal> ai componenti EJB di Seam. Quest'interceptor delega ad un set di interceptor predefiniti lato server che gestiscono i concern quali la bijection, la demarcazione delle conversazioni ed i segnali del processo di business. Il modo più semplice per fare questo in tutta l'applicazione è aggiungere la seguente configurazione per l'interceptor in <literal>ejb-jar.xml</literal>:" #. Tag: programlisting #: Configuration.xml:355 @@ -704,13 +704,13 @@ #: Configuration.xml:368 #, no-c-format msgid "In this case, <literal>earName</literal> is the name of the EAR in which the bean is deployed, Seam replaces <literal>#{ejbName}</literal> with the name of the EJB, and the final segment represents the type of interface (local or remote)." -msgstr "" +msgstr "In questo caso <literal>earName</literal> è il nome dell'EAR in cui viene deployato il bean, Seam sostituisce <literal>#{ejbName}</literal> con il nome dell'EJB ed il segmento finale rappresenta il tipo di interfaccia (locale o remota)." #. Tag: para #: Configuration.xml:372 #, no-c-format msgid "Outside the context of an EAR (when using the JBoss Embeddable EJB3 container), the first segment is dropped since there is no EAR, leaving us with the following pattern:" -msgstr "" +msgstr "Fuori dal contesto di un EAR (quando si usa il container JBoss Embeddable EJB3) il primo segmento viene ignorato poiché non c'è alcun EAR, rimanendo quindi con il seguente pattern:" #. Tag: programlisting #: Configuration.xml:375 @@ -722,13 +722,13 @@ #: Configuration.xml:377 #, no-c-format msgid "How these JNDI names are resolved and somehow locate an EJB component might appear a bit like black magic at this point, so let's dig into the details. First, let's talk about how the EJB components get into JNDI." -msgstr "" +msgstr "Come questi nomi JNDI vengono risolti e come localizzare un componente EJB potrebbe apparire a questo punto un pò una questione di magia, quindi indaghiamo meglio i dettagli. Innanzitutto vediamo come i componenti EJB entrano in JNDI." #. Tag: para #: Configuration.xml:381 #, no-c-format msgid "The folks at JBoss don't care much for XML, if you can't tell. So when they designed JBoss AS, they decided that EJB components would get assigned a global JNDI name automatically, using the pattern just described (i.e., EAR name/EJB name/interface type). The EJB name is the first non-empty value from the following list:" -msgstr "" +msgstr "Le persone di JBoss non si preoccupano molto di XML. Quindi quando hanno progettato JBoss AS, hanno deciso che i componenti EJB avrebbero visto assegnarsi automaticamente un nome JNDI globale, usando il pattern appena descritto (cioè nome EAR/nome EJB/tipo interfaccia). Il nome EJB è il primo valore non vuoto della seguente lista:" #. Tag: para #: Configuration.xml:387 @@ -806,19 +806,19 @@ #: Configuration.xml:401 #, no-c-format msgid "Assuming your EJB bean class is deployed in an EAR named myapp, the global JNDI name myapp/AuthenticatorBean/local will be assigned to it on JBoss AS. As you learned, you can reference this EJB component as a Seam component with the name <literal>authenticator</literal> and Seam will take care of finding it in JNDI according to the JNDI pattern (or <literal>@JndiName</literal> annotation)." -msgstr "" +msgstr "Assumendo che la classe del bean EJB sia deployata in un'applicazione EAR chiamata myapp, il nome JNDI globale myapp/AuthenticatorBean/local verrà assegnato a lei in JBoss AS. Come visto, si può fare riferimento a questo componente EJB come componente Seam con il nome <literal>authenticator</literal> e Seam si preoccuperà di trovarlo in JNDI secondo il pattern JNDI (o l'annotazione <literal>@JndiName</literal>)." #. Tag: para #: Configuration.xml:407 #, no-c-format msgid "So what about the rest of the application servers? Well, according to the Java EE spec, which most vendors try to adhere to religiously, you have to declare an EJB reference for your EJB in order for it to be assigned a JNDI name. That requires some XML. It also means that it is up to you to establish a JNDI naming convention so that you can leverage the Seam JNDI pattern. You might find the JBoss convention a good one to follow." -msgstr "" +msgstr "Ma cosa dire rispetto ai restanti application server? In accordo alla specifica Java EE, alla quale la maggior parte dei venditori cerca di aderire in modo religioso, si deve dichiarare un riferimento EJB per il proprio EJB affinché gli venga assegnato un nome JNDI. Questo richiede un pò di XML. Significa che sta a voi stabilire una convenzione di nomi JNDI per poter sfruttare il pattern JNDI di Seam. Si potrebbe ritenere buona e usare la convenzione JBoss." #. Tag: para #: Configuration.xml:413 #, no-c-format msgid "There are two places you have to define the EJB reference when using Seam on non-JBoss application servers. If you are going to be looking up the Seam EJB component through JSF (in a JSF view or as a JSF action listener) or a Seam JavaBean component, then you must declare the EJB reference in web.xml. Here is the EJB reference for the example component just shown:" -msgstr "" +msgstr "Ci sono due posti dove poter definire il riferimento EJB usando Seam su application server non-JBoss. Se si cercheranno i componenti EJB di Seam attraverso JSF (in una vista JSF o in un action listener JSF) od un componente JavaBean di Seam, allora occorre dichiarare il riferimento EJB in web.xml. Ecco qua il riferimento EJB per il componente d'esempio appena mostrato:" #. Tag: programlisting #: Configuration.xml:418 @@ -842,13 +842,13 @@ #: Configuration.xml:420 #, no-c-format msgid "This reference will cover most uses of the component in a Seam application. However, if you want to be able to inject a Seam EJB component into another Seam EJB component using <literal>@In</literal>, you need to define this EJB reference in another location. This time, it must be defined in ejb-jar.xml, and it's a bit tricker." -msgstr "" +msgstr "Questo riferimento coprirà la maggior parte degli usi dei componenti in un'applicazione Seam. Comunque se si vuole essere in grado di iniettare un componente EJB di Seam in un altro componente usando <literal>@In</literal>, occorre definire questo riferimento EJB in un'altra posizione. Questa volta deve essere definito in ejb-jar.xml, ed è un pò più complicato." #. Tag: para #: Configuration.xml:425 #, no-c-format msgid "Within the context of an EJB method call, you have to deal with a somewhat sheltered JNDI context. When Seam attempts to find another Seam EJB component to satisfy an injection point defined using <literal>@In</literal>, whether or not it finds it depends on whether an EJB reference exists in JNDI. Strictly speaking, you cannot simply resolve JNDI names as you please. You have to define the references explicitly. Fortunately, JBoss recognized how aggrevating this would be for the developer and all versions of JBoss automatically register EJBs so they are always available in JNDI, both to the web container and the EJB container. So if you are using JBoss, you can skip the next few paragraphs. However, if you are deploying to GlassFish, pay close attention." -msgstr "" +msgstr "Dentro il contesto di una chiamata di metodo EJB, occorre avere a che fare con un contesto JNDI protetto. Quando Seam tenta di trovare un altro componente EJB Seam per soddisfare un punto d'iniezione definito con <literal>@In</literal>, il fatto che Seam lo trovi oppure no dipende dal fatto che esista un riferimento EJB in JNDI. In senso letterale non si può semplicemente risolvere i nomi JNDI a proprio piacimento. Occorre definire esplicitamente i riferimenti. Fortunatamente JBoss ha capito come questo sarebbe aggravante per lo sviluppatore e quindi tutte le versioni di JBoss registrano automaticamente gli EJB cosicché siano sempre disponibili in JNDI, sia nel web container sia nell'EJB container. In definitiva se si usa JBoss, si possono saltare i prossimi paragrafi. Comunque, se si usa GlassFish, si presti molta attenzione." #. Tag: para #: Configuration.xml:434 @@ -1408,13 +1408,13 @@ #: Configuration.xml:681 #, no-c-format msgid "Of course, you'll also need to define a datasource." -msgstr "" +msgstr "Certamente occorre definire un datasource." #. Tag: para #: Configuration.xml:683 #, no-c-format msgid "A better alternative is to use JBoss Embedded to get access to the EE APIs." -msgstr "" +msgstr "Un'alternativa migliore è usare JBoss Embedded per accedere alle API EE." #. Tag: title #: Configuration.xml:688

16 years, 11 months

1
0
0 / 0

Seam SVN: r10941 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-22 18:10:49 -0400 (Fri, 22 May 2009) New Revision: 10941 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po 2009-05-22 18:05:03 UTC (rev 10940) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po 2009-05-22 22:10:49 UTC (rev 10941) @@ -6,7 +6,7 @@ "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" "POT-Creation-Date: 2009-03-31 09:07+0000\n" -"PO-Revision-Date: 2009-05-22 20:04+0100\n" +"PO-Revision-Date: 2009-05-23 00:10+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -1118,7 +1118,7 @@ #: Events.xml:548 #, no-c-format msgid "You might wonder why I've not mentioned anything about event objects in this discussion. In Seam, there is no need for an event object to propagate state between event producer and listener. State is held in the Seam contexts, and is shared between components. However, if you really want to pass an event object, you can:" -msgstr "" +msgstr "Ci si potrebbe chiedere perché in questa discussione non si è menzionato niente riguardo gli oggetti evento. In Seam non c'è bisogno di un oggetto evento per propagare lo stato tra produttore evento e listener. Lo stato viene mantenuto nei contesti Seam e viene condiviso tra i componenti. Comunque se si vuole passare un oggetto evento, si può:" #. Tag: programlisting #: Events.xml:556 @@ -1470,7 +1470,7 @@ #: Events.xml:633 #, no-c-format msgid "To apply this interceptor to a session bean which acts as an action listener, we must annotate the session bean <literal>@Interceptors(LoggedInInterceptor.class)</literal>. This is a somewhat ugly annotation. Seam builds upon the interceptor framework in EJB3 by allowing you to use <literal>@Interceptors</literal> as a meta-annotation for class level interceptors (those annotated <literal>@Target(TYPE)</literal>). In our example, we would create an <literal>@LoggedIn</literal> annotation, as follows:" -msgstr "" +msgstr "Per applicare quest'interceptor ad un bean di sessione che agisce come action listener, si deve annotare il bean con <literal>@Interceptors(LoggedInInterceptor.class)</literal>. E' un'annotazione un pò brutta. Seam è basato sul framework interceptor di EJB3 e consente di usare <literal>@Interceptors</literal> come meta-annotazione per gli interceptor di livello classe (quelli annotati con <literal>@Target(TYPE)</literal>). Nell'esempio si vuole creare un'annotazione <literal>@LoggedIn</literal>, come segue:" #. Tag: programlisting #: Events.xml:642 @@ -1574,13 +1574,13 @@ #: Events.xml:666 #, no-c-format msgid "EJB interceptors are stateful, with a lifecycle that is the same as the component they intercept. For interceptors which do not need to maintain state, Seam lets you get a performance optimization by specifying <literal>@Interceptor(stateless=true)</literal>." -msgstr "" +msgstr "Gli interceptor EJB sono stateful, con un ciclo di vita che è lo stesso dei componenti che intercettano. Per gli interceptor che non hanno bisogno di mantenere uno stato, Seam consente di ottenere un'ottimizzazione di performance specificando <literal>@Interceptor(stateless=true)</literal>." #. Tag: para #: Events.xml:673 #, no-c-format msgid "Much of the functionality of Seam is implemented as a set of built-in Seam interceptors, including the interceptors named in the previous example. You don't have to explicitly specify these interceptors by annotating your components; they exist for all interceptable Seam components." -msgstr "" +msgstr "Molte delle funzionalità di Seam sono implementate come set di interceptor predefiniti, includendo gli interceptor chiamati nel precedente esempio. Non è necessario specificare esplicitamente questi interceptor annotando i componenti; esistono per tutti i componenti Seam intercettabili." #. Tag: para #: Events.xml:680 @@ -1604,7 +1604,7 @@ #: Events.xml:698 #, no-c-format msgid "JSF is surprisingly limited when it comes to exception handling. As a partial workaround for this problem, Seam lets you define how a particular class of exception is to be treated by annotating the exception class, or declaring the exception class in an XML file. This facility is meant to be combined with the EJB 3.0-standard <literal>@ApplicationException</literal> annotation which specifies whether the exception should cause a transaction rollback." -msgstr "" +msgstr "JSF è soprendentemente limitato quando si tratta di gestione delle eccezioni. Come parziale soluzione a questo problema, Seam consente di definire come una particolare classe di eccezioni debba essere trattata annotando la classe eccezione o dichiarando l'eccezione in un file XML. Quest'opzione ha il significato di essere combinata con l'annotazione standard EJB3.0 <literal>@ApplicationException</literal> che specifica se l'eccezione debba causare un rollback della transazione." #. Tag: title #: Events.xml:708 @@ -1622,7 +1622,7 @@ #: Events.xml:723 #, no-c-format msgid "Note that there is a difference between marking a transaction for rollback, and actually rolling it back. The exception rules say that the transaction should be marked rollback only, but it may still be active after the exception is thrown." -msgstr "" +msgstr "Si noti la differenza fra marcare una transazione per il rollback ed eseguire effettivamente il rollback. Le regole di eccezione dicono che la transazione debba essere solo marcata rollback, ma questa possa essere attiva dopo che l'eccezione venga lanciata." #. Tag: para #: Events.xml:730 @@ -1634,7 +1634,7 @@ #: Events.xml:735 #, no-c-format msgid "But these rules only apply in the Seam component layer. What about an exception that is uncaught and propagates out of the Seam component layer, and out of the JSF layer? Well, it is always wrong to leave a dangling transaction open, so Seam rolls back any active transaction when an exception occurs and is uncaught in the Seam component layer." -msgstr "" +msgstr "Queste regole si applicano solo al layer componenti di Seam. Ma cosa succede se un'eccezione che non viene catturata si propaga fuori dal layer componenti di Seam, e fuori dal layer JSF? E' sempre sbagliato lasciare aperta una transazione pendente, quindi Seam esegue il rollback per ogni transazione attiva quando avviene un'eccezione e non viene catturata dal layer componenti di Seam." #. Tag: title #: Events.xml:745 @@ -1676,7 +1676,7 @@ #: Events.xml:754 #, no-c-format msgid "You need to disable Facelets development mode in <literal>web.xml</literal> and Seam debug mode in <literal>components.xml</literal> if you want your exception handlers to fire." -msgstr "" +msgstr "Occorre disabilitare la modalità sviluppo di Facelets in <literal>web.xml</literal> e la modalità debug di Seam in <literal>components.xml</literal> se si vuole eseguire la gestione eccezioni." #. Tag: title #: Events.xml:763 @@ -1688,7 +1688,7 @@ #: Events.xml:765 #, no-c-format msgid "The following exception results in a HTTP 404 error whenever it propagates out of the Seam component layer. It does not roll back the current transaction immediately when thrown, but the transaction will be rolled back if it the exception is not caught by another Seam component." -msgstr "" +msgstr "La seguente eccezione ha origine in un errore HTTP 404 quanfo si propaga fuori dal layer componenti di Seam. Non esegue immediatamente il rollback della transazione quando lanciata, ma il rollback avverrà se l'eccezione non viene catturata da un altro componente Seam." #. Tag: programlisting #: Events.xml:772 @@ -1704,7 +1704,7 @@ #: Events.xml:774 #, no-c-format msgid "This exception results in a browser redirect whenever it propagates out of the Seam component layer. It also ends the current conversation. It causes an immediate rollback of the current transaction." -msgstr "" +msgstr "Quest'eccezione ha origine in un redirect del browser quando si propaga fuori dal layer componenti di Seam. Termina anche la conversazione corrente e causa un immediato rollback della transazione." #. Tag: programlisting #: Events.xml:780 @@ -1872,7 +1872,7 @@ #: Events.xml:838 #, no-c-format msgid "For the exception handlers defined in <literal>pages.xml</literal>, it is possible to declare the logging level at which the exception will be logged, or to even suppress the exception being logged altogether. The attributes <literal>log</literal> and <literal>log-level</literal> can be used to control exception logging. By setting <literal>log=\"false\"</literal> as per the following example, then no log message will be generated when the specified exception occurs:" -msgstr "" +msgstr "Per la gestione eccezioni definita in <literal>pages.xml</literal>, è possibile dichiarare il livello di logging con cui loggare l'eccezione o anche sopprimere l'eccezioneche viene loggata altrove. Gli attributi <literal>log</literal> e <literal>log-level</literal> possono essere usati per controllare il logging dell'eccezione. Impostando <literal>log=\"false\"</literal> come nel prossimo esempio, allora non verrà generato alcun messaggio quando avviene l'eccezione specificata:" #. Tag: programlisting #: Events.xml:847 @@ -1916,7 +1916,7 @@ #: Events.xml:857 #, no-c-format msgid "The acceptable values for <literal>log-level</literal> are: <literal>fatal, error, warn, info, debug</literal> or <literal>trace</literal>. If the <literal>log-level</literal> is not specified, or if an invalid value is configured, then it will default to <literal>error</literal>." -msgstr "" +msgstr "Valori accettabili per <literal>log-level</literal> sono: <literal>fatal, error, warn, info, debug</literal> o <literal>trace</literal>. Se non viene specificato <literal>log-level</literal> o se è configurato un valore non valido, allora il default è <literal>error</literal>." #. Tag: title #: Events.xml:868 @@ -2054,7 +2054,7 @@ #: Events.xml:906 #, no-c-format msgid "When specified as the attribute of a <literal>page</literal> element in <literal>pages.xml</literal>, this setting controls whether a page requires an active long-running or nested conversation before being rendered. If there is not an active long-running or nested conversation when trying to access the page, you will be redirected to the <literal>no-conversation-view-id</literal> view (which is specified in the root <literal>pages</literal> element) instead." -msgstr "" +msgstr "Quando è specificato come attributo dell'elemento <literal>page</literal> in <literal>pages.xml</literal>, quest'impostazione controlla se una pagina richiede una conversazione attiva long-running o annidata prima di essere renderizzata. Se, quando si accede alla pagina, non ci sono né una conversazione attiva long-running né annidata, si verrà invece ridiretti alla vista <literal>no-conversation-view-id</literal> (che viene specificata nell'elemento radice <literal>pages</literal>)" #. Tag: programlisting #: Events.xml:914

16 years, 11 months

1
0
0 / 0

Seam SVN: r10940 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

by seam-commits＠lists.jboss.org

Author: nico.ben Date: 2009-05-22 14:05:03 -0400 (Fri, 22 May 2009) New Revision: 10940 Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po Log: JBSEAM-3767: Italian translation of Seam guide Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po =================================================================== --- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po 2009-05-22 09:36:20 UTC (rev 10939) +++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Events.po 2009-05-22 18:05:03 UTC (rev 10940) @@ -6,7 +6,7 @@ "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" "POT-Creation-Date: 2009-03-31 09:07+0000\n" -"PO-Revision-Date: 2009-05-21 21:25+0100\n" +"PO-Revision-Date: 2009-05-22 20:04+0100\n" "Last-Translator: Nicola Benaglia <nico.benaz(a)gmail.com>\n" "Language-Team: none\n" "MIME-Version: 1.0\n" @@ -630,7 +630,7 @@ #: Events.xml:376 #, no-c-format msgid "You can use standard JSF navigation rules defined in <literal>faces-config.xml</literal> in a Seam application. However, JSF navigation rules have a number of annoying limitations:" -msgstr "" +msgstr "Si possono usare le regole di navigazione standard di JSF definite in <literal>faces-config.xml</literal> in un'applicazione Seam. Comunque le regole di navigazione hanno un certo numero spiacevole di limitazioni:" #. Tag: para #: Events.xml:384 @@ -654,7 +654,7 @@ #: Events.xml:401 #, no-c-format msgid "A further problem is that \"orchestration\" logic gets scattered between <literal>pages.xml</literal> and <literal>faces-config.xml</literal>. It's better to unify this logic into <literal>pages.xml</literal>." -msgstr "" +msgstr "Un altro problema è che la logica di \"orchestrazione\" viene sparsa tra <literal>pages.xml</literal> e <literal>faces-config.xml</literal>. E' meglio unificare questa logica in <literal>pages.xml</literal>." #. Tag: para #: Events.xml:406 @@ -724,7 +724,7 @@ #: Events.xml:418 #, no-c-format msgid "But it would be even nicer if we didn't have to pollute our <literal>DocumentEditor</literal> component with string-valued return values (the JSF outcomes). So Seam lets us write:" -msgstr "" +msgstr "Ma sarebbe ancora meglio non dover inquinare il componente <literal>DocumentEditor</literal> con valori di ritorno stringa (gli esiti JSF). Quindi Seam consente di scrivere:" #. Tag: programlisting #: Events.xml:423 @@ -786,7 +786,7 @@ #: Events.xml:431 #, no-c-format msgid "The first form evaluates a value binding to determine the outcome value to be used by the subsequent rules. The second approach ignores the outcome and evaluates a value binding for each possible rule." -msgstr "" +msgstr "La prima form valuta un valore di binding per determinare il valore d'esito da impiegare nelle regole. Il secondo approccio ignora l'esito e valuta un valore di binding per ogni possibile regola." #. Tag: para #: Events.xml:438 @@ -824,7 +824,7 @@ #: Events.xml:445 #, no-c-format msgid "As we've ended conversation any subsequent requests won't know which document we are interested in. We can pass the document id as a request parameter which also makes the view bookmarkable:" -msgstr "" +msgstr "Appena terminata la conversazione ogni ulteriore richiesta non saprebbe quale sia il documento di interesse. Si può passare l'id documento come parametro di richiesta che renderebbe la vista memorizzabile come segnalibro:" #. Tag: programlisting #: Events.xml:451 @@ -860,7 +860,7 @@ #: Events.xml:453 #, no-c-format msgid "Null outcomes are a special case in JSF. The null outcome is interpreted to mean \"redisplay the page\". The following navigation rule matches any non-null outcome, but <emphasis>not</emphasis> the null outcome:" -msgstr "" +msgstr "Esiti null sono un caso speciale in JSF. L'esito null viene interpretato come \"rivisualizza la pagina\". La seguente regola di navigazione cerca esiti non-null, ma <emphasis>non</emphasis> l'esito null:" #. Tag: programlisting #: Events.xml:459 @@ -952,7 +952,7 @@ #: Events.xml:479 #, no-c-format msgid "If you have a lot of different page actions and page parameters, or even just a lot of navigation rules, you will almost certainly want to split the declarations up over multiple files. You can define actions and parameters for a page with the view id <literal>/calc/calculator.jsp</literal> in a resource named <literal>calc/calculator.page.xml</literal>. The root element in this case is the <literal><page></literal> element, and the view id is implied:" -msgstr "" +msgstr "Si si hanno molte differenti azioni e parametri di pagina, od anche solo molte regole di navigazione, si vuole quasi sicuramente separare le dichiarazioni in molti file. Si possono definire azioni e parametri per una pagina con id vista <literal>/calc/calculator.jsp</literal> in una risorsa chiamata <literal>calc/calculator.page.xml</literal>. L'elemento radice in questo caso è l'elemento <literal><page></literal>, e l'id vista è implicito:" #. Tag: programlisting #: Events.xml:490 @@ -980,7 +980,7 @@ #: Events.xml:499 #, no-c-format msgid "Seam components can interact by simply calling each others methods. Stateful components may even implement the observer/observable pattern. But to enable components to interact in a more loosely-coupled fashion than is possible when the components call each others methods directly, Seam provides <emphasis>component-driven events</emphasis>." -msgstr "" +msgstr "I componenti Seam possono interagire semplicemente chiamando gli uni i metodi degli altri. I componenti stateful possono anche implementare il pattern observer/observable. Ma per abilitare i componenti per interagire in un modo più disaccoppiato rispetto a quando i componenti chiamano direttamente i metodi, Seam fornisce <emphasis>eventi component-driven</emphasis>." #. Tag: para #: Events.xml:507 @@ -1016,7 +1016,7 @@ #: Events.xml:517 #, no-c-format msgid "When an event occurs, the actions registered for that event will be called in the order they appear in <literal>components.xml</literal>. How does a component raise an event? Seam provides a built-in component for this." -msgstr "" +msgstr "Quando avviene un evento, le azioni registrate per quest'evento verrà chiamato nell'ordine in cui appare in <literal>components.xml</literal>. Come un componente genera un evento? Seam fornisce un componente predefinito per questo." #. Tag: programlisting #: Events.xml:523 @@ -1092,7 +1092,7 @@ #: Events.xml:539 #, no-c-format msgid "The method binding defined in <literal>components.xml</literal> above takes care of mapping the event to the consumer. If you don't like futzing about in the <literal>components.xml</literal> file, you can use an annotation instead:" -msgstr "" +msgstr "Il binding di metodo definito sopra in <literal>components.xml</literal> si preoccupare di mappare l'evento al consumatore. Se non si vuole metter mano al file <literal>components.xml</literal>, si possono usare le annotazioni:" #. Tag: programlisting #: Events.xml:546 @@ -1172,7 +1172,7 @@ #: Events.xml:564 #, no-c-format msgid "Seam defines a number of built-in events that the application can use to perform special kinds of framework integration. The events are:" -msgstr "" +msgstr "Seam definisce un numero di eventi predefinito che l'applicazione può usare per eseguire l'integrazione col framework. Questi eventi sono:" #. Tag: para #: Events.xml:570 @@ -1424,7 +1424,7 @@ #: Events.xml:622 #, no-c-format msgid "EJB 3.0 introduced a standard interceptor model for session bean components. To add an interceptor to a bean, you need to write a class with a method annotated <literal>@AroundInvoke</literal> and annotate the bean with an <literal>@Interceptors</literal> annotation that specifies the name of the interceptor class. For example, the following interceptor checks that the user is logged in before allowing invoking an action listener method:" -msgstr "" +msgstr "EJB 3.0 ha introdotto un modello di interceptor standard per componenti session bean. Per aggiungere un interceptor ad un bean, occorre scrivere una classe con un metodo annotato con <literal>@AroundInvoke</literal> ed annotare il bean con l'annotazione <literal>@Interceptors</literal> che specifica ilnome della classe interceptor. Per esempio, il seguente interceptor controlla che l'utente sia loggato prima di consentire l'invocazione di un metodo action listener:" #. Tag: programlisting #: Events.xml:631 @@ -1592,7 +1592,7 @@ #: Events.xml:684 #, no-c-format msgid "EJB defines interception not only for business methods (using <literal>@AroundInvoke</literal>), but also for the lifecycle methods <literal>@PostConstruct</literal>, <literal>@PreDestroy</literal>, <literal>@PrePassivate</literal> and <literal>@PostActive</literal>. Seam supports all these lifecycle methods on both component and interceptor not only for EJB3 beans, but also for JavaBean components (except <literal>@PreDestroy</literal> which is not meaningful for JavaBean components)." -msgstr "" +msgstr "EJB definisce l'interception non solo per i metodi di business (usando <literal>@AroundInvoke</literal>), ma anche per i metodi del ciclo di vita <literal>@PostConstruct</literal>, <literal>@PreDestroy</literal>, <literal>@PrePassivate</literal> e <literal>@PostActive</literal>. Seam supporta tutti questi metodi del ciclo di vita sia per i componenti sia per gli interceptor, non solo per bean EJB3, ma anche per componenti JavaBean (tranne <literal>@PreDestroy</literal> che non è significativo per i componenti JavaBean)." #. Tag: title #: Events.xml:696 @@ -1616,7 +1616,7 @@ #: Events.xml:710 #, no-c-format msgid "EJB specifies well-defined rules that let us control whether an exception immediately marks the current transaction for rollback when it is thrown by a business method of the bean: <emphasis>system exceptions</emphasis> always cause a transaction rollback, <emphasis>application exceptions</emphasis> do not cause a rollback by default, but they do if <literal>@ApplicationException(rollback=true)</literal> is specified. (An application exception is any checked exception, or any unchecked exception annotated <literal>@ApplicationException</literal>. A system exception is any unchecked exception without an <literal>@ApplicationException</literal> annotation.)" -msgstr "" +msgstr "EJB specifica regole ben-definite che consentono di controllare se un'eccezione marca immediatamente la transazione corrente per il rollback quando è lanciata da un metodo business del bean: <emphasis>eccezioni di sistema</emphasis> causano sempre un rollback della transazione, <emphasis>eccezioni di applicazione</emphasis> di default non causano un rollback, ma lo fanno se viene specificato <literal>@ApplicationException(rollback=true)</literal>. (Un'eccezione di applicazione è una qualsiasi eccezione controllata, o una qualsiasi eccezioni non controllata annotatacon <literal>@ApplicationException</literal>. Un'eccezione di sistema è una qualsiasi eccezioni non controllata senza l'annotazione <literal>@ApplicationException</literal>.)" #. Tag: para #: Events.xml:723 @@ -1646,7 +1646,7 @@ #: Events.xml:747 #, no-c-format msgid "To enable Seam's exception handling, we need to make sure we have the master servlet filter declared in <literal>web.xml</literal>:" -msgstr "" +msgstr "Per abilitare la gestione delle eccezioni in Seam, occorre aver dichiarato il filtro servlet in <literal>web.xml</literal>:" #. Tag: programlisting #: Events.xml:752 @@ -1722,7 +1722,7 @@ #: Events.xml:782 #, no-c-format msgid "It is important to note that Seam cannot handle exceptions that occur during JSF's RENDER_RESPONSE phase, as it is not possible to perform a redirect once the response has started being written to." -msgstr "" +msgstr "E'importante notare che Seam non può gestire le eccezioni che avvengono duranre la fase RENDER_RESPONSE di JSF, poiché non è possibile eseguire un redirect una volta che si è iniziato a scrivere la risposta." #. Tag: para #: Events.xml:788 @@ -1810,7 +1810,7 @@ #: Events.xml:812 #, no-c-format msgid "The last <literal><exception></literal> declaration does not specify a class, and is a catch-all for any exception for which handling is not otherwise specified via annotations or in <literal>pages.xml</literal>." -msgstr "" +msgstr "L'ultima dichiarazione <literal><exception></literal> non specifica una classe, ed è un cattura-tutto per qualsiasi eccezione per cui la gestione non è altrimenti specifica tramite annotazioni o in <literal>pages.xml</literal>." #. Tag: para #: Events.xml:818

16 years, 11 months

1
0
0 / 0

Seam SVN: r10939 - tags.

by seam-commits＠lists.jboss.org

Author: manaRH Date: 2009-05-22 05:36:20 -0400 (Fri, 22 May 2009) New Revision: 10939 Added: tags/JBPAPP_CP07_CP05/ Removed: tags/JBPAPP_CP06_CP05/ Log: Copied: tags/JBPAPP_CP07_CP05 (from rev 10938, tags/JBPAPP_CP06_CP05)

16 years, 11 months

1
0
0 / 0

Seam SVN: r10938 - tags.

by seam-commits＠lists.jboss.org

Author: manaRH Date: 2009-05-22 05:34:59 -0400 (Fri, 22 May 2009) New Revision: 10938 Added: tags/JBPAPP_CP06_CP05/ Log: tagging EAP 4.2 CP07 and 4.3 CP05 release Copied: tags/JBPAPP_CP06_CP05 (from rev 10937, branches/enterprise/JBPAPP_4_2_CP01)

16 years, 11 months

1
0
0 / 0

← Newer
1
...
9
10
11
12
13
14
15
...
32
Older →

Jump to page:

2026

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

seam-commits May 2009