[seam-commits] Seam SVN: r10718 - branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT.

seam-commits at lists.jboss.org seam-commits at lists.jboss.org
Wed Apr 29 08:53:39 EDT 2009


Author: nico.ben
Date: 2009-04-29 08:53:38 -0400 (Wed, 29 Apr 2009)
New Revision: 10718

Modified:
   branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Framework.po
   branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Security.po
   branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Webservices.po
Log:
JBSEAM-3767: Italian translation of Seam guide

Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Framework.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Framework.po	2009-04-29 11:48:02 UTC (rev 10717)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Framework.po	2009-04-29 12:53:38 UTC (rev 10718)
@@ -5,8 +5,8 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-01-18 15:00+0000\n"
-"PO-Revision-Date: 2009-02-23 21:40+0100\n"
+"POT-Creation-Date: 2009-04-29 12:40+0000\n"
+"PO-Revision-Date: 2009-04-29 14:48+0100\n"
 "Last-Translator: Nicola Benaglia <nico.benaz at gmail.com>\n"
 "Language-Team: none\n"
 "MIME-Version: 1.0\n"
@@ -548,7 +548,7 @@
 #. Tag: para
 #: Framework.xml:212
 #, no-c-format
-msgid "The Home object raises an <literal>org.jboss.seam.afterTransactionSuccess</literal> event when a transaction succeeds (a call to <literal>persist()</literal>, <literal>update()</literal> or <literal>remove()</literal> succeeds). By observing this event we can refresh our queries when the underlying entities are changed. If we only want to refresh certain queries when a particular entity is persited, updated or removed we can observe the <literal>org.jboss.seam.afterTransactionSuccess.&lt;name&gt;</literal> event (where <literal>&lt;name&gt;</literal> is the name of the entity)."
+msgid "The Home object raises an <literal>org.jboss.seam.afterTransactionSuccess</literal> event when a transaction succeeds (a call to <literal>persist()</literal>, <literal>update()</literal> or <literal>remove()</literal> succeeds). By observing this event we can refresh our queries when the underlying entities are changed. If we only want to refresh certain queries when a particular entity is persisted, updated or removed we can observe the <literal>org.jboss.seam.afterTransactionSuccess.&lt;name&gt;</literal> event (where <literal>&lt;name&gt;</literal> is the name of the entity)."
 msgstr "L'oggetto Home solleva un'evento <literal>org.jboss.seam.afterTransactionSuccess</literal> quando una transazione ha successo (una chiamata a <literal>persist()</literal>, <literal>update()</literal> o <literal>remove()</literal> ha successo). Osservando questo evento si può fare il refresh delle query quando le entità sottostanti cambiano. Se si vuole solo eseguire il refresh quando una particolare entità viene persistita, aggiornata o rimossa, si può osservare l'evento <literal>org.jboss.seam.afterTransactionSuccess.&lt;name&gt;</literal> (dove <literal>&lt;name&gt;</literal> è il nome dell'entity)."
 
 #. Tag: para
@@ -934,7 +934,7 @@
 #. Tag: para
 #: Framework.xml:320
 #, no-c-format
-msgid "Unfortunately Query objects don't work well with <emphasis>join fetch</emphasis> queries - the use of pagination with these queries is not recomended, and you'll have to implement your own method of calculating the total number of results (by overriding <literal>getCountEjbql()</literal>."
+msgid "Unfortunately Query objects don't work well with <emphasis>join fetch</emphasis> queries - the use of pagination with these queries is not recommended, and you'll have to implement your own method of calculating the total number of results (by overriding <literal>getCountEjbql()</literal>."
 msgstr "Sfortunatamente gli oggetti Query non funzionano bene con query <emphasis>join fetch</emphasis> - non è consigliato l'uso della paginazione con queste query, ed occorrerà implementare un proprio metodo di calcolo del numero totale di risultati (con l'override di <literal>getCountEjbql()</literal>)."
 
 #. Tag: para

Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Security.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Security.po	2009-04-29 11:48:02 UTC (rev 10717)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Security.po	2009-04-29 12:53:38 UTC (rev 10718)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: Security\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-04-07 12:40+0000\n"
+"POT-Creation-Date: 2009-04-29 12:40+0000\n"
 "PO-Revision-Date: 2009-03-24 09:12+0100\n"
 "Last-Translator: \n"
 "Language-Team: Italian <stefano.travelli at gmail.com>\n"
@@ -1723,7 +1723,7 @@
 msgstr "Annotazioni per l'entità utente"
 
 #. Tag: para
-#: Security.xml:630 Security.xml:764 Security.xml:3370 Security.xml:3533
+#: Security.xml:630 Security.xml:764 Security.xml:3382 Security.xml:3545
 #, no-c-format
 msgid "Annotation"
 msgstr "Annotazione"
@@ -1736,8 +1736,8 @@
 
 #. Tag: para
 #: Security.xml:636 Security.xml:770 Security.xml:966 Security.xml:1418
-#: Security.xml:2147 Security.xml:2756 Security.xml:3159 Security.xml:3376
-#: Security.xml:3539 Security.xml:3780 Security.xml:4217
+#: Security.xml:2147 Security.xml:2756 Security.xml:3171 Security.xml:3388
+#: Security.xml:3551 Security.xml:3792 Security.xml:4229
 #, no-c-format
 msgid "Description"
 msgstr "Descrizione"
@@ -3036,8 +3036,8 @@
 msgstr "API per la gestione delle identità"
 
 #. Tag: para
-#: Security.xml:1412 Security.xml:1828 Security.xml:2753 Security.xml:3156
-#: Security.xml:3777 Security.xml:3946
+#: Security.xml:1412 Security.xml:1828 Security.xml:2753 Security.xml:3168
+#: Security.xml:3789 Security.xml:3958
 #, no-c-format
 msgid "Method"
 msgstr "Metodo"
@@ -3058,9 +3058,9 @@
 #: Security.xml:1433 Security.xml:1452 Security.xml:1471 Security.xml:1490
 #: Security.xml:1509 Security.xml:1529 Security.xml:1548 Security.xml:1567
 #: Security.xml:1586 Security.xml:1606 Security.xml:1626 Security.xml:1740
-#: Security.xml:1762 Security.xml:1780 Security.xml:2766 Security.xml:3227
-#: Security.xml:3246 Security.xml:3265 Security.xml:3283 Security.xml:3828
-#: Security.xml:3847 Security.xml:3866 Security.xml:3885
+#: Security.xml:1762 Security.xml:1780 Security.xml:2766 Security.xml:3239
+#: Security.xml:3258 Security.xml:3277 Security.xml:3295 Security.xml:3840
+#: Security.xml:3859 Security.xml:3878 Security.xml:3897
 #, no-c-format
 msgid "boolean"
 msgstr "boolean"
@@ -3426,13 +3426,13 @@
 msgstr "Permessi di sicurezza nella gestione delle identità"
 
 #. Tag: para
-#: Security.xml:1831 Security.xml:3949
+#: Security.xml:1831 Security.xml:3961
 #, no-c-format
 msgid "Permission Target"
 msgstr "Oggetto del permesso"
 
 #. Tag: para
-#: Security.xml:1834 Security.xml:3952
+#: Security.xml:1834 Security.xml:3964
 #, no-c-format
 msgid "Permission Action"
 msgstr "Azione del permesso"
@@ -5116,7 +5116,7 @@
 msgstr "L'interfaccia PermissionResolver"
 
 #. Tag: para
-#: Security.xml:2750 Security.xml:3153 Security.xml:3774
+#: Security.xml:2750 Security.xml:3165 Security.xml:3786
 #, no-c-format
 msgid "Return type"
 msgstr "Tipo restituito"
@@ -5168,14 +5168,29 @@
 "<literal>hasPermission()</literal> con lo stesso valore del parametro "
 "<literal>action</literal>."
 
+#. Tag: para
+#: Security.xml:2809
+#, no-c-format
+msgid ""
+"As they are cached in the user's session, any custom "
+"<literal>PermissionResolver</literal> implementations must adhere to a "
+"couple of restrictions. Firstly, they may not contain any state that is "
+"finer-grained than session scope (and the scope of the component itself "
+"should either be application or session). Secondly, they must not use "
+"dependency injection as they may be accessed from multiple threads "
+"simultaneously. In fact, for performance reasons it is recommended that they "
+"are annotated with <literal>@BypassInterceptors</literal> to bypass Seam's "
+"interceptor stack altogether."
+msgstr ""
+
 #. Tag: title
-#: Security.xml:2812
+#: Security.xml:2824
 #, no-c-format
 msgid "ResolverChain"
 msgstr "ResolverChain"
 
 #. Tag: para
-#: Security.xml:2814
+#: Security.xml:2826
 #, no-c-format
 msgid ""
 "A <literal>ResolverChain</literal> contains an ordered list of "
@@ -5187,7 +5202,7 @@
 "sugli oggetti di una determinata classe oppure i permessi obiettivo."
 
 #. Tag: para
-#: Security.xml:2819
+#: Security.xml:2831
 #, no-c-format
 msgid ""
 "The default <literal>ResolverChain</literal> consists of all permission "
@@ -5201,7 +5216,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:2828
+#: Security.xml:2840
 #, no-c-format
 msgid ""
 "The following sequence diagram shows the interaction between the components "
@@ -5219,7 +5234,7 @@
 "<literal>Identity.checkPermission</literal>:"
 
 #. Tag: para
-#: Security.xml:2846
+#: Security.xml:2858
 #, no-c-format
 msgid ""
 "1. A permission check is initiated somewhere (either in code or via an EL "
@@ -5231,7 +5246,7 @@
 "hasPermission()</literal>."
 
 #. Tag: para
-#: Security.xml:2852
+#: Security.xml:2864
 #, no-c-format
 msgid ""
 "1.1. <literal>Identity</literal> invokes <literal>PermissionMapper."
@@ -5241,7 +5256,7 @@
 "resolvePermission()</literal>, passando il permesso che deve essere risolto."
 
 #. Tag: para
-#: Security.xml:2859
+#: Security.xml:2871
 #, no-c-format
 msgid ""
 "1.1.1. <literal>PermissionMapper</literal> maintains a <literal>Map</"
@@ -5260,7 +5275,7 @@
 "<literal>ResolverChain.getResolvers()</literal>."
 
 #. Tag: para
-#: Security.xml:2869
+#: Security.xml:2881
 #, no-c-format
 msgid ""
 "1.1.2. For each <literal>PermissionResolver</literal> in the "
@@ -5284,13 +5299,13 @@
 "<literal>true</literal>, allora la verifica del permesso è fallita."
 
 #. Tag: title
-#: Security.xml:2885
+#: Security.xml:2897
 #, no-c-format
 msgid "RuleBasedPermissionResolver"
 msgstr "RuleBasedPermissionResolver"
 
 #. Tag: para
-#: Security.xml:2887
+#: Security.xml:2899
 #, no-c-format
 msgid ""
 "One of the built-in permission resolvers provided by Seam, "
@@ -5311,13 +5326,13 @@
 "multiple."
 
 #. Tag: title
-#: Security.xml:2896
+#: Security.xml:2908
 #, no-c-format
 msgid "Requirements"
 msgstr "Requisiti"
 
 #. Tag: para
-#: Security.xml:2898
+#: Security.xml:2910
 #, no-c-format
 msgid ""
 "If using the rule-based permission features provided by Seam Security, the "
@@ -5329,43 +5344,43 @@
 "insieme al progetto:"
 
 #. Tag: para
-#: Security.xml:2905
+#: Security.xml:2917
 #, no-c-format
 msgid "drools-compiler.jar"
 msgstr "drools-compiler.jar"
 
 #. Tag: para
-#: Security.xml:2908
+#: Security.xml:2920
 #, no-c-format
 msgid "drools-core.jar"
 msgstr "drools-core.jar"
 
 #. Tag: para
-#: Security.xml:2911
+#: Security.xml:2923
 #, no-c-format
 msgid "janino.jar"
 msgstr "janino.jar"
 
 #. Tag: para
-#: Security.xml:2914
+#: Security.xml:2926
 #, no-c-format
 msgid "antlr-runtime.jar"
 msgstr "antlr-runtime.jar"
 
 #. Tag: para
-#: Security.xml:2917
+#: Security.xml:2929
 #, no-c-format
 msgid "mvel14.jar"
 msgstr "mvel14.jar"
 
 #. Tag: title
-#: Security.xml:2924 Security.xml:3116
+#: Security.xml:2936 Security.xml:3128
 #, no-c-format
 msgid "Configuration"
 msgstr "Configurazione"
 
 #. Tag: para
-#: Security.xml:2926
+#: Security.xml:2938
 #, no-c-format
 msgid ""
 "The configuration for <literal>RuleBasedPermissionResolver</literal> "
@@ -5380,7 +5395,7 @@
 "esempio:"
 
 #. Tag: programlisting
-#: Security.xml:2932
+#: Security.xml:2944
 #, no-c-format
 msgid ""
 "<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -5430,7 +5445,7 @@
 "  </components>]]>"
 
 #. Tag: para
-#: Security.xml:2934
+#: Security.xml:2946
 #, no-c-format
 msgid ""
 "The default rule base name can be overridden by specifying the "
@@ -5442,7 +5457,7 @@
 "<literal>RuleBasedPermissionResolver</literal>:"
 
 #. Tag: programlisting
-#: Security.xml:2939
+#: Security.xml:2951
 #, no-c-format
 msgid ""
 "<![CDATA[\n"
@@ -5454,7 +5469,7 @@
 "{prodSecurityRules}\"/>]]>"
 
 #. Tag: para
-#: Security.xml:2941
+#: Security.xml:2953
 #, no-c-format
 msgid ""
 "Once the <literal>RuleBase</literal> component is configured, it's time to "
@@ -5464,13 +5479,13 @@
 "momento di scrivere le regole di sicurezza."
 
 #. Tag: title
-#: Security.xml:2947
+#: Security.xml:2959
 #, no-c-format
 msgid "Writing Security Rules"
 msgstr "Scrivere le regole di sicurezza"
 
 #. Tag: para
-#: Security.xml:2949
+#: Security.xml:2961
 #, no-c-format
 msgid ""
 "The first step to writing security rules is to create a new rule file in the "
@@ -5487,7 +5502,7 @@
 "<literal>components.xml</literal>."
 
 #. Tag: para
-#: Security.xml:2956
+#: Security.xml:2968
 #, no-c-format
 msgid ""
 "So what should the security rules file contain? At this stage it might be a "
@@ -5499,7 +5514,7 @@
 "Drools, comunque per partire ecco un esempio estremamente semplice:"
 
 #. Tag: programlisting
-#: Security.xml:2961
+#: Security.xml:2973
 #, no-c-format
 msgid ""
 "<![CDATA[package MyApplicationPermissions;\n"
@@ -5529,7 +5544,7 @@
 "  end]]>"
 
 #. Tag: para
-#: Security.xml:2963
+#: Security.xml:2975
 #, no-c-format
 msgid ""
 "Let's break this down step by step. The first thing we see is the package "
@@ -5543,7 +5558,7 @@
 "sia al di fuori della visibilità della base di regole."
 
 #. Tag: para
-#: Security.xml:2969
+#: Security.xml:2981
 #, no-c-format
 msgid ""
 "The next thing we can notice is a couple of import statements for the "
@@ -5558,7 +5573,7 @@
 "queste classi."
 
 #. Tag: para
-#: Security.xml:2975
+#: Security.xml:2987
 #, no-c-format
 msgid ""
 "Finally we have the code for the rule. Each rule within a package should be "
@@ -5573,7 +5588,7 @@
 "cancellare un record relativo ad un cliente."
 
 #. Tag: para
-#: Security.xml:2981
+#: Security.xml:2993
 #, no-c-format
 msgid ""
 "Looking at the body of the rule definition we can notice two distinct "
@@ -5598,7 +5613,7 @@
 "regola è stabilita dalla linea <literal>end</literal>."
 
 #. Tag: para
-#: Security.xml:2990
+#: Security.xml:3002
 #, no-c-format
 msgid ""
 "If we look at the LHS of the rule, we see two conditions listed there. Let's "
@@ -5608,7 +5623,7 @@
 "condizioni. Esaminiamo la prima condizione:"
 
 #. Tag: programlisting
-#: Security.xml:2994
+#: Security.xml:3006
 #, no-c-format
 msgid ""
 "<![CDATA[c: PermissionCheck(target == \"customer\", action == \"delete\")]]>"
@@ -5616,7 +5631,7 @@
 "<![CDATA[c: PermissionCheck(target == \"customer\", action == \"delete\")]]>"
 
 #. Tag: para
-#: Security.xml:2996
+#: Security.xml:3008
 #, no-c-format
 msgid ""
 "In plain english, this condition is stating that there must exist a "
@@ -5630,7 +5645,7 @@
 "<literal>action</literal> uguale a \"delete\"."
 
 #. Tag: para
-#: Security.xml:3002
+#: Security.xml:3014
 #, no-c-format
 msgid ""
 "So what is the working memory? Also known as a \"stateful session\" in "
@@ -5661,7 +5676,7 @@
 "literal> uguale a \"create\", per la durata del controllo di permesso."
 
 #. Tag: para
-#: Security.xml:3014
+#: Security.xml:3026
 #, no-c-format
 msgid ""
 "Besides the <literal>PermissionCheck</literal> facts, there is also a "
@@ -5690,7 +5705,7 @@
 "risultato del processo di autentifica."
 
 #. Tag: para
-#: Security.xml:3025
+#: Security.xml:3037
 #, no-c-format
 msgid ""
 "It is also possible to insert additional long-lived facts into the working "
@@ -5706,7 +5721,7 @@
 "all'inizio di ciascun controllo di permesso."
 
 #. Tag: para
-#: Security.xml:3032
+#: Security.xml:3044
 #, no-c-format
 msgid ""
 "Getting back to our simple example, we can also notice that the first line "
@@ -5723,13 +5738,13 @@
 "questo:"
 
 #. Tag: programlisting
-#: Security.xml:3039
+#: Security.xml:3051
 #, no-c-format
 msgid "<![CDATA[Role(name == \"admin\")]]>"
 msgstr "<![CDATA[Role(name == \"admin\")]]>"
 
 #. Tag: para
-#: Security.xml:3041
+#: Security.xml:3053
 #, no-c-format
 msgid ""
 "This condition simply states that there must be a <literal>Role</literal> "
@@ -5749,7 +5764,7 @@
 "delete</literal> e l'utente è un membro del ruolo <literal>admin</literal>\"."
 
 #. Tag: para
-#: Security.xml:3049
+#: Security.xml:3061
 #, no-c-format
 msgid ""
 "So what is the consequence of the rule firing? Let's take a look at the RHS "
@@ -5759,13 +5774,13 @@
 "un'occhiata alla parte destra della regola:"
 
 #. Tag: programlisting
-#: Security.xml:3053
+#: Security.xml:3065
 #, no-c-format
 msgid "<![CDATA[c.grant()]]>"
 msgstr "<![CDATA[c.grant()]]>"
 
 #. Tag: para
-#: Security.xml:3055
+#: Security.xml:3067
 #, no-c-format
 msgid ""
 "The RHS consists of Java code, and in this case is invoking the "
@@ -5794,13 +5809,13 @@
 "inteso."
 
 #. Tag: title
-#: Security.xml:3069
+#: Security.xml:3081
 #, no-c-format
 msgid "Non-String permission targets"
 msgstr "Permessi con obiettivi non stringa"
 
 #. Tag: para
-#: Security.xml:3071
+#: Security.xml:3083
 #, no-c-format
 msgid ""
 "So far we have only seen permission checks for String-literal permission "
@@ -5822,7 +5837,7 @@
 "correntemente autenticato sia un membro del ruolo <literal>user</literal>:"
 
 #. Tag: programlisting
-#: Security.xml:3080
+#: Security.xml:3092
 #, no-c-format
 msgid ""
 "<![CDATA[rule CanCreateBlogComment\n"
@@ -5852,13 +5867,13 @@
 "]]>"
 
 #. Tag: title
-#: Security.xml:3085
+#: Security.xml:3097
 #, no-c-format
 msgid "Wildcard permission checks"
 msgstr "Controlli di permesso "
 
 #. Tag: para
-#: Security.xml:3087
+#: Security.xml:3099
 #, no-c-format
 msgid ""
 "It is possible to implement a wildcard permission check (which allows all "
@@ -5872,7 +5887,7 @@
 "<literal>PermissionCheck</literal> nella regola, in questo modo:"
 
 #. Tag: programlisting
-#: Security.xml:3093
+#: Security.xml:3105
 #, no-c-format
 msgid ""
 "<![CDATA[rule CanDoAnythingToCustomersIfYouAreAnAdmin\n"
@@ -5894,7 +5909,7 @@
 "        ]]>"
 
 #. Tag: para
-#: Security.xml:3095
+#: Security.xml:3107
 #, no-c-format
 msgid ""
 "This rule allows users with the <literal>admin</literal> role to perform "
@@ -5906,13 +5921,13 @@
 "permesso su <literal>customer</literal>."
 
 #. Tag: title
-#: Security.xml:3105
+#: Security.xml:3117
 #, no-c-format
 msgid "PersistentPermissionResolver"
 msgstr "PersistentPermissionResolver"
 
 #. Tag: para
-#: Security.xml:3107
+#: Security.xml:3119
 #, no-c-format
 msgid ""
 "Another built-in permission resolver provided by Seam, "
@@ -5933,7 +5948,7 @@
 "(non necessariamente basato sull'oggetto o la classe). "
 
 #. Tag: para
-#: Security.xml:3118
+#: Security.xml:3130
 #, no-c-format
 msgid ""
 "Before it can be used, <literal>PersistentPermissionResolver</literal> must "
@@ -5946,7 +5961,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3126
+#: Security.xml:3138
 #, no-c-format
 msgid ""
 "<![CDATA[  <security:persistent-permission-resolver permission-store=\"#"
@@ -5956,13 +5971,13 @@
 "{myCustomPermissionStore}\"/>]]>"
 
 #. Tag: title
-#: Security.xml:3131
+#: Security.xml:3143
 #, no-c-format
 msgid "Permission Stores"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3133
+#: Security.xml:3145
 #, no-c-format
 msgid ""
 "A permission store is required for <literal>PersistentPermissionResolver</"
@@ -5975,26 +5990,26 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3143
+#: Security.xml:3155
 #, no-c-format
 msgid "PermissionStore interface"
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3169 Security.xml:3188 Security.xml:3207 Security.xml:3790
-#: Security.xml:3809
+#: Security.xml:3181 Security.xml:3200 Security.xml:3219 Security.xml:3802
+#: Security.xml:3821
 #, no-c-format
 msgid "List&lt;Permission&gt;"
 msgstr "List&lt;Permission&gt;"
 
 #. Tag: literal
-#: Security.xml:3174 Security.xml:3814
+#: Security.xml:3186 Security.xml:3826
 #, no-c-format
 msgid "listPermissions(Object target)"
 msgstr "listPermissions(Object target)"
 
 #. Tag: para
-#: Security.xml:3178
+#: Security.xml:3190
 #, no-c-format
 msgid ""
 "This method should return a <literal>List</literal> of <literal>Permission</"
@@ -6003,13 +6018,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3193 Security.xml:3795
+#: Security.xml:3205 Security.xml:3807
 #, no-c-format
 msgid "listPermissions(Object target, String action)"
 msgstr "listPermissions(Object target, String action)"
 
 #. Tag: para
-#: Security.xml:3197
+#: Security.xml:3209
 #, no-c-format
 msgid ""
 "This method should return a <literal>List</literal> of <literal>Permission</"
@@ -6018,13 +6033,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3212
+#: Security.xml:3224
 #, no-c-format
 msgid "listPermissions(Set&lt;Object&gt; targets, String action)"
 msgstr "listPermissions(Set&lt;Object&gt; targets, String action)"
 
 #. Tag: para
-#: Security.xml:3216
+#: Security.xml:3228
 #, no-c-format
 msgid ""
 "This method should return a <literal>List</literal> of <literal>Permission</"
@@ -6033,13 +6048,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3232
+#: Security.xml:3244
 #, no-c-format
 msgid "grantPermission(Permission)"
 msgstr "grantPermission(Permission)"
 
 #. Tag: para
-#: Security.xml:3236
+#: Security.xml:3248
 #, no-c-format
 msgid ""
 "This method should persist the specified <literal>Permission</literal> "
@@ -6047,13 +6062,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3251 Security.xml:3852
+#: Security.xml:3263 Security.xml:3864
 #, no-c-format
 msgid "grantPermissions(List&lt;Permission&gt; permissions)"
 msgstr "grantPermissions(List&lt;Permission&gt; permissions)"
 
 #. Tag: para
-#: Security.xml:3255
+#: Security.xml:3267
 #, no-c-format
 msgid ""
 "This method should persist all of the <literal>Permission</literal> objects "
@@ -6062,13 +6077,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3270 Security.xml:3871
+#: Security.xml:3282 Security.xml:3883
 #, no-c-format
 msgid "revokePermission(Permission permission)"
 msgstr "revokePermission(Permission permission)"
 
 #. Tag: para
-#: Security.xml:3274
+#: Security.xml:3286
 #, no-c-format
 msgid ""
 "This method should remove the specified <literal>Permission</literal> object "
@@ -6076,13 +6091,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3288 Security.xml:3890
+#: Security.xml:3300 Security.xml:3902
 #, no-c-format
 msgid "revokePermissions(List&lt;Permission&gt; permissions)"
 msgstr "revokePermissions(List&lt;Permission&gt; permissions)"
 
 #. Tag: para
-#: Security.xml:3292
+#: Security.xml:3304
 #, no-c-format
 msgid ""
 "This method should remove all of the <literal>Permission</literal> objects "
@@ -6090,19 +6105,19 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3302 Security.xml:3904
+#: Security.xml:3314 Security.xml:3916
 #, no-c-format
 msgid "List&lt;String&gt;"
 msgstr "List&lt;String&gt;"
 
 #. Tag: literal
-#: Security.xml:3307 Security.xml:3909
+#: Security.xml:3319 Security.xml:3921
 #, no-c-format
 msgid "listAvailableActions(Object target)"
 msgstr "listAvailableActions(Object target)"
 
 #. Tag: para
-#: Security.xml:3311
+#: Security.xml:3323
 #, no-c-format
 msgid ""
 "This method should return a list of all the available actions (as Strings) "
@@ -6112,13 +6127,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3325
+#: Security.xml:3337
 #, no-c-format
 msgid "JpaPermissionStore"
 msgstr "JpaPermissionStore"
 
 #. Tag: para
-#: Security.xml:3327
+#: Security.xml:3339
 #, no-c-format
 msgid ""
 "This is the default <literal>PermissionStore</literal> implementation (and "
@@ -6131,7 +6146,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3335
+#: Security.xml:3347
 #, no-c-format
 msgid ""
 "If you wish to use the same entity (i.e. a single database table) to store "
@@ -6143,7 +6158,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3342
+#: Security.xml:3354
 #, no-c-format
 msgid ""
 "For example, to configure a single entity class to store both user and role "
@@ -6151,7 +6166,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3344
+#: Security.xml:3356
 #, no-c-format
 msgid ""
 "<![CDATA[  <security:jpa-permission-store user-permission-class=\"com.acme."
@@ -6161,14 +6176,14 @@
 "model.AccountPermission\"/>]]>"
 
 #. Tag: para
-#: Security.xml:3346
+#: Security.xml:3358
 #, no-c-format
 msgid ""
 "To configure separate entity classes for storing user and role permissions:"
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3348
+#: Security.xml:3360
 #, no-c-format
 msgid ""
 "<![CDATA[  <security:jpa-permission-store user-permission-class=\"com.acme."
@@ -6180,13 +6195,13 @@
 "    role-permission-class=\"com.acme.model.RolePermission\"/>]]>"
 
 #. Tag: title
-#: Security.xml:3351
+#: Security.xml:3363
 #, no-c-format
 msgid "Permission annotations"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3353
+#: Security.xml:3365
 #, no-c-format
 msgid ""
 "As mentioned, the entity classes that contain the user and role permissions "
@@ -6197,32 +6212,32 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3360
+#: Security.xml:3372
 #, no-c-format
 msgid "Entity Permission annotations"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3373 Security.xml:3536
+#: Security.xml:3385 Security.xml:3548
 #, no-c-format
 msgid "Target"
 msgstr "Target"
 
 #. Tag: literal
-#: Security.xml:3386
+#: Security.xml:3398
 #, no-c-format
 msgid "@PermissionTarget"
 msgstr "@PermissionTarget"
 
 #. Tag: literal
-#: Security.xml:3391 Security.xml:3410 Security.xml:3429 Security.xml:3448
-#: Security.xml:3467
+#: Security.xml:3403 Security.xml:3422 Security.xml:3441 Security.xml:3460
+#: Security.xml:3479
 #, no-c-format
 msgid "FIELD,METHOD"
 msgstr "FIELD,METHOD"
 
 #. Tag: para
-#: Security.xml:3395
+#: Security.xml:3407
 #, no-c-format
 msgid ""
 "This annotation identifies the property of the entity that will contain the "
@@ -6231,13 +6246,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3405
+#: Security.xml:3417
 #, no-c-format
 msgid "@PermissionAction"
 msgstr "@PermissionAction"
 
 #. Tag: para
-#: Security.xml:3414
+#: Security.xml:3426
 #, no-c-format
 msgid ""
 "This annotation identifies the property of the entity that will contain the "
@@ -6246,13 +6261,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3424
+#: Security.xml:3436
 #, no-c-format
 msgid "@PermissionUser"
 msgstr "@PermissionUser"
 
 #. Tag: para
-#: Security.xml:3433
+#: Security.xml:3445
 #, no-c-format
 msgid ""
 "This annotation identifies the property of the entity that will contain the "
@@ -6261,13 +6276,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3443
+#: Security.xml:3455
 #, no-c-format
 msgid "@PermissionRole"
 msgstr "@PermissionRole"
 
 #. Tag: para
-#: Security.xml:3452
+#: Security.xml:3464
 #, no-c-format
 msgid ""
 "This annotation identifies the property of the entity that will contain the "
@@ -6276,13 +6291,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3462
+#: Security.xml:3474
 #, no-c-format
 msgid "@PermissionDiscriminator"
 msgstr "@PermissionDiscriminator"
 
 #. Tag: para
-#: Security.xml:3471
+#: Security.xml:3483
 #, no-c-format
 msgid ""
 "This annotation should be used when the same entity/table is used to store "
@@ -6299,7 +6314,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3481
+#: Security.xml:3493
 #, no-c-format
 msgid ""
 "<![CDATA[  @PermissionDiscriminator(userValue = \"u\", roleValue = \"r\")]]>"
@@ -6307,13 +6322,13 @@
 "<![CDATA[  @PermissionDiscriminator(userValue = \"u\", roleValue = \"r\")]]>"
 
 #. Tag: title
-#: Security.xml:3492
+#: Security.xml:3504
 #, no-c-format
 msgid "Example Entity"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3494
+#: Security.xml:3506
 #, no-c-format
 msgid ""
 "Here is an example of an entity class that is used to store both user and "
@@ -6322,7 +6337,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3499
+#: Security.xml:3511
 #, no-c-format
 msgid ""
 "<![CDATA[\n"
@@ -6438,7 +6453,7 @@
 "          ]]>"
 
 #. Tag: para
-#: Security.xml:3501
+#: Security.xml:3513
 #, no-c-format
 msgid ""
 "As can be seen in the above example, the <literal>getDiscriminator()</"
@@ -6455,13 +6470,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3514
+#: Security.xml:3526
 #, no-c-format
 msgid "Class-specific Permission Configuration"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3516
+#: Security.xml:3528
 #, no-c-format
 msgid ""
 "A further set of class-specific annotations can be used to configure a "
@@ -6471,25 +6486,25 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3523
+#: Security.xml:3535
 #, no-c-format
 msgid "Class Permission Annotations"
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3549
+#: Security.xml:3561
 #, no-c-format
 msgid "@Permissions"
 msgstr "@Permissions"
 
 #. Tag: literal
-#: Security.xml:3554 Security.xml:3572
+#: Security.xml:3566 Security.xml:3584
 #, no-c-format
 msgid "TYPE"
 msgstr "TYPE"
 
 #. Tag: para
-#: Security.xml:3558
+#: Security.xml:3570
 #, no-c-format
 msgid ""
 "A container annotation, this annotation may contain an array of "
@@ -6497,13 +6512,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3567
+#: Security.xml:3579
 #, no-c-format
 msgid "@Permission"
 msgstr "@Permission"
 
 #. Tag: para
-#: Security.xml:3576
+#: Security.xml:3588
 #, no-c-format
 msgid ""
 "This annotation defines a single allowable permission action for the target "
@@ -6514,7 +6529,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3588
+#: Security.xml:3600
 #, no-c-format
 msgid ""
 "Here's an example of the above annotations in action. The following class "
@@ -6522,7 +6537,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3592
+#: Security.xml:3604
 #, no-c-format
 msgid ""
 "<![CDATA[@Permissions({\n"
@@ -6540,7 +6555,7 @@
 "public class MemberImage implements Serializable {]]>"
 
 #. Tag: para
-#: Security.xml:3594
+#: Security.xml:3606
 #, no-c-format
 msgid ""
 "This example demonstrates how two allowable permission actions, "
@@ -6549,13 +6564,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3602
+#: Security.xml:3614
 #, no-c-format
 msgid "Permission masks"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3604
+#: Security.xml:3616
 #, no-c-format
 msgid ""
 "By default, multiple permissions for the same target object and recipient "
@@ -6567,7 +6582,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3611
+#: Security.xml:3623
 #, no-c-format
 msgid ""
 "For example, if recipient \"Bob\" is granted both the <literal>view</"
@@ -6580,7 +6595,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3618
+#: Security.xml:3630
 #, no-c-format
 msgid ""
 "<![CDATA[@Permissions({\n"
@@ -6598,7 +6613,7 @@
 "public class MemberImage implements Serializable {]]>"
 
 #. Tag: para
-#: Security.xml:3620
+#: Security.xml:3632
 #, no-c-format
 msgid ""
 "The <literal>action</literal> property will instead simply contain \"3"
@@ -6608,7 +6623,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3626
+#: Security.xml:3638
 #, no-c-format
 msgid ""
 "Obviously, it is very important that the <literal>mask</literal> values "
@@ -6616,13 +6631,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3632
+#: Security.xml:3644
 #, no-c-format
 msgid "Identifier Policy"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3634
+#: Security.xml:3646
 #, no-c-format
 msgid ""
 "When storing or looking up permissions, <literal>JpaPermissionStore</"
@@ -6636,7 +6651,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3642
+#: Security.xml:3654
 #, no-c-format
 msgid ""
 "The <literal>IdentifierStrategy</literal> interface is very simple, "
@@ -6644,7 +6659,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3646
+#: Security.xml:3658
 #, no-c-format
 msgid ""
 "<![CDATA[public interface IdentifierStrategy {\n"
@@ -6658,7 +6673,7 @@
 "}]]>"
 
 #. Tag: para
-#: Security.xml:3648
+#: Security.xml:3660
 #, no-c-format
 msgid ""
 "The first method, <literal>canIdentify()</literal> simply returns "
@@ -6669,7 +6684,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3654
+#: Security.xml:3666
 #, no-c-format
 msgid ""
 "Seam provides two <literal>IdentifierStrategy</literal> implementations, "
@@ -6678,7 +6693,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3659
+#: Security.xml:3671
 #, no-c-format
 msgid ""
 "To explicitly configure a specific identifier strategy to use for a "
@@ -6691,13 +6706,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3669
+#: Security.xml:3681
 #, no-c-format
 msgid "ClassIdentifierStrategy"
 msgstr "ClassIdentifierStrategy"
 
 #. Tag: para
-#: Security.xml:3671
+#: Security.xml:3683
 #, no-c-format
 msgid ""
 "This identifier strategy is used to generate unique identifiers for classes, "
@@ -6711,7 +6726,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3680
+#: Security.xml:3692
 #, no-c-format
 msgid ""
 "<![CDATA[@Identifier(name = \"customer\")\n"
@@ -6721,7 +6736,7 @@
 "public class Customer {]]>"
 
 #. Tag: para
-#: Security.xml:3682
+#: Security.xml:3694
 #, no-c-format
 msgid ""
 "The identifier for the following class will be \"<literal>customerAction</"
@@ -6729,7 +6744,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3686
+#: Security.xml:3698
 #, no-c-format
 msgid ""
 "<![CDATA[@Name(\"customerAction\")\n"
@@ -6739,7 +6754,7 @@
 "public class CustomerAction { ]]>"
 
 #. Tag: para
-#: Security.xml:3688
+#: Security.xml:3700
 #, no-c-format
 msgid ""
 "Finally, the identifier for the following class will be \"<literal>Customer</"
@@ -6747,19 +6762,19 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3692
+#: Security.xml:3704
 #, no-c-format
 msgid "<![CDATA[public class Customer { ]]>"
 msgstr "<![CDATA[public class Customer { ]]>"
 
 #. Tag: title
-#: Security.xml:3697
+#: Security.xml:3709
 #, no-c-format
 msgid "EntityIdentifierStrategy"
 msgstr "EntityIdentifierStrategy"
 
 #. Tag: para
-#: Security.xml:3699
+#: Security.xml:3711
 #, no-c-format
 msgid ""
 "This identifier strategy is used to generate unique identifiers for entity "
@@ -6776,7 +6791,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3710
+#: Security.xml:3722
 #, no-c-format
 msgid ""
 "<![CDATA[@Identifier(value = EntityIdentifierStrategy.class)\n"
@@ -6786,7 +6801,7 @@
 "public class Customer { ]]>"
 
 #. Tag: para
-#: Security.xml:3712
+#: Security.xml:3724
 #, no-c-format
 msgid ""
 "For an example of the type of identifier values generated, assume we have "
@@ -6794,7 +6809,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3716
+#: Security.xml:3728
 #, no-c-format
 msgid ""
 "<![CDATA[@Entity\n"
@@ -6834,7 +6849,7 @@
 "}]]>"
 
 #. Tag: para
-#: Security.xml:3718
+#: Security.xml:3730
 #, no-c-format
 msgid ""
 "For a <literal>Customer</literal> instance with an <literal>id</literal> "
@@ -6844,7 +6859,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3724
+#: Security.xml:3736
 #, no-c-format
 msgid ""
 "<![CDATA[@Entity\n"
@@ -6856,7 +6871,7 @@
 "public class Customer { ]]>"
 
 #. Tag: para
-#: Security.xml:3726
+#: Security.xml:3738
 #, no-c-format
 msgid ""
 "Then a <literal>Customer</literal> with an <literal>id</literal> value of "
@@ -6865,13 +6880,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3739
+#: Security.xml:3751
 #, no-c-format
 msgid "Permission Management"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3741
+#: Security.xml:3753
 #, no-c-format
 msgid ""
 "In much the same way that Seam Security provides an Identity Management API "
@@ -6881,13 +6896,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3748
+#: Security.xml:3760
 #, no-c-format
 msgid "PermissionManager"
 msgstr "PermissionManager"
 
 #. Tag: para
-#: Security.xml:3750
+#: Security.xml:3762
 #, no-c-format
 msgid ""
 "The <literal>PermissionManager</literal> component is an application-scoped "
@@ -6900,7 +6915,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:3757
+#: Security.xml:3769
 #, no-c-format
 msgid ""
 "<![CDATA[\n"
@@ -6914,7 +6929,7 @@
 "      ]]>"
 
 #. Tag: para
-#: Security.xml:3759
+#: Security.xml:3771
 #, no-c-format
 msgid ""
 "The following table describes each of the available methods provided by "
@@ -6922,13 +6937,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3764
+#: Security.xml:3776
 #, no-c-format
 msgid "PermissionManager API methods"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3799 Security.xml:3818
+#: Security.xml:3811 Security.xml:3830
 #, no-c-format
 msgid ""
 "Returns a list of <literal>Permission</literal> objects representing all of "
@@ -6936,13 +6951,13 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3833
+#: Security.xml:3845
 #, no-c-format
 msgid "grantPermission(Permission permission)"
 msgstr "grantPermission(Permission permission)"
 
 #. Tag: para
-#: Security.xml:3837
+#: Security.xml:3849
 #, no-c-format
 msgid ""
 "Persists (grants) the specified <literal>Permission</literal> to the backend "
@@ -6950,7 +6965,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3856
+#: Security.xml:3868
 #, no-c-format
 msgid ""
 "Persists (grants) the specified list of <literal>Permission</literal>s to "
@@ -6958,7 +6973,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3875
+#: Security.xml:3887
 #, no-c-format
 msgid ""
 "Removes (revokes) the specified <literal>Permission</literal> from the "
@@ -6966,7 +6981,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3894
+#: Security.xml:3906
 #, no-c-format
 msgid ""
 "Removes (revokes) the specified list of <literal>Permission</literal>s from "
@@ -6974,7 +6989,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3913
+#: Security.xml:3925
 #, no-c-format
 msgid ""
 "Returns a list of the available actions for the specified target object. The "
@@ -6983,13 +6998,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3928
+#: Security.xml:3940
 #, no-c-format
 msgid "Permission checks for PermissionManager operations"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:3930
+#: Security.xml:3942
 #, no-c-format
 msgid ""
 "Invoking the methods of <literal>PermissionManager</literal> requires that "
@@ -6999,37 +7014,37 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:3937
+#: Security.xml:3949
 #, no-c-format
 msgid "Permission Management Security Permissions"
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3961
+#: Security.xml:3973
 #, no-c-format
 msgid "listPermissions()"
 msgstr "listPermissions()"
 
 #. Tag: para
-#: Security.xml:3965
+#: Security.xml:3977
 #, no-c-format
 msgid "The specified <literal>target</literal>"
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3971
+#: Security.xml:3983
 #, no-c-format
 msgid "seam.read-permissions"
 msgstr "seam.read-permissions"
 
 #. Tag: literal
-#: Security.xml:3979 Security.xml:3999
+#: Security.xml:3991 Security.xml:4011
 #, no-c-format
 msgid "grantPermission()"
 msgstr "grantPermission()"
 
 #. Tag: para
-#: Security.xml:3983
+#: Security.xml:3995
 #, no-c-format
 msgid ""
 "The target of the specified <literal>Permission</literal>, or each of the "
@@ -7038,56 +7053,56 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:3991 Security.xml:4009 Security.xml:4027
+#: Security.xml:4003 Security.xml:4021 Security.xml:4039
 #, no-c-format
 msgid "seam.grant-permission"
 msgstr "seam.grant-permission"
 
 #. Tag: para
-#: Security.xml:4003 Security.xml:4039
+#: Security.xml:4015 Security.xml:4051
 #, no-c-format
 msgid "The target of the specified <literal>Permission</literal>."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4017
+#: Security.xml:4029
 #, no-c-format
 msgid "grantPermissions()"
 msgstr "grantPermissions()"
 
 #. Tag: para
-#: Security.xml:4021 Security.xml:4057
+#: Security.xml:4033 Security.xml:4069
 #, no-c-format
 msgid ""
 "Each of the targets of the specified list of <literal>Permission</literal>s."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4035
+#: Security.xml:4047
 #, no-c-format
 msgid "revokePermission()"
 msgstr "revokePermission()"
 
 #. Tag: literal
-#: Security.xml:4045 Security.xml:4063
+#: Security.xml:4057 Security.xml:4075
 #, no-c-format
 msgid "seam.revoke-permission"
 msgstr "seam.revoke-permission"
 
 #. Tag: literal
-#: Security.xml:4053
+#: Security.xml:4065
 #, no-c-format
 msgid "revokePermissions()"
 msgstr "revokePermissions()"
 
 #. Tag: title
-#: Security.xml:4076
+#: Security.xml:4088
 #, no-c-format
 msgid "SSL Security"
 msgstr "SSL Security"
 
 #. Tag: para
-#: Security.xml:4078
+#: Security.xml:4090
 #, no-c-format
 msgid ""
 "Seam includes basic support for serving sensitive pages via the HTTPS "
@@ -7098,13 +7113,13 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4085
+#: Security.xml:4097
 #, no-c-format
 msgid "<![CDATA[<page view-id=\"/login.xhtml\" scheme=\"https\"/>]]>"
 msgstr "<![CDATA[<page view-id=\"/login.xhtml\" scheme=\"https\"/>]]>"
 
 #. Tag: para
-#: Security.xml:4087
+#: Security.xml:4099
 #, no-c-format
 msgid ""
 "This configuration is automatically extended to both <literal>s:link</"
@@ -7116,13 +7131,13 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4094
+#: Security.xml:4106
 #, no-c-format
 msgid "<![CDATA[<s:link view=\"/login.xhtml\" value=\"Login\"/>]]>"
 msgstr "<![CDATA[<s:link view=\"/login.xhtml\" value=\"Login\"/>]]>"
 
 #. Tag: para
-#: Security.xml:4096
+#: Security.xml:4108
 #, no-c-format
 msgid ""
 "Browsing directly to a view when using the <emphasis>incorrect</emphasis> "
@@ -7133,7 +7148,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4103
+#: Security.xml:4115
 #, no-c-format
 msgid ""
 "It is also possible to configure a <emphasis>default scheme</emphasis> for "
@@ -7147,13 +7162,13 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4112
+#: Security.xml:4124
 #, no-c-format
 msgid "<![CDATA[<page view-id=\"*\" scheme=\"http\" />]]>"
 msgstr "<![CDATA[<page view-id=\"*\" scheme=\"http\" />]]>"
 
 #. Tag: para
-#: Security.xml:4114
+#: Security.xml:4126
 #, no-c-format
 msgid ""
 "Of course, if <emphasis>none</emphasis> of the pages in your application use "
@@ -7161,7 +7176,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4119
+#: Security.xml:4131
 #, no-c-format
 msgid ""
 "You may configure Seam to automatically invalidate the current HTTP session "
@@ -7170,13 +7185,13 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4124
+#: Security.xml:4136
 #, no-c-format
 msgid "<![CDATA[<web:session invalidate-on-scheme-change=\"true\"/>]]>"
 msgstr "<![CDATA[<web:session invalidate-on-scheme-change=\"true\"/>]]>"
 
 #. Tag: para
-#: Security.xml:4126
+#: Security.xml:4138
 #, no-c-format
 msgid ""
 "This option helps make your system less vulnerable to sniffing of the "
@@ -7185,13 +7200,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4132
+#: Security.xml:4144
 #, no-c-format
 msgid "Overriding the default ports"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4134
+#: Security.xml:4146
 #, no-c-format
 msgid ""
 "If you wish to configure the HTTP and HTTPS ports manually, they may be "
@@ -7201,7 +7216,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4140
+#: Security.xml:4152
 #, no-c-format
 msgid ""
 "<![CDATA[\n"
@@ -7227,13 +7242,13 @@
 "      ]]>"
 
 #. Tag: title
-#: Security.xml:4146
+#: Security.xml:4158
 #, no-c-format
 msgid "CAPTCHA"
 msgstr "CAPTCHA"
 
 #. Tag: para
-#: Security.xml:4148
+#: Security.xml:4160
 #, no-c-format
 msgid ""
 "Though strictly not part of the security API, Seam provides a built-in "
@@ -7245,13 +7260,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4156
+#: Security.xml:4168
 #, no-c-format
 msgid "Configuring the CAPTCHA Servlet"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4157
+#: Security.xml:4169
 #, no-c-format
 msgid ""
 "To get up and running, it is necessary to configure the Seam Resource "
@@ -7260,7 +7275,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4162
+#: Security.xml:4174
 #, no-c-format
 msgid ""
 "<![CDATA[<servlet>\n"
@@ -7286,20 +7301,20 @@
 "</servlet-mapping>]]>"
 
 #. Tag: title
-#: Security.xml:4167
+#: Security.xml:4179
 #, no-c-format
 msgid "Adding a CAPTCHA to a form"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4169
+#: Security.xml:4181
 #, no-c-format
 msgid ""
 "Adding a CAPTCHA challenge to a form is extremely easy. Here's an example:"
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4173
+#: Security.xml:4185
 #, no-c-format
 msgid ""
 "<![CDATA[<h:graphicImage value=\"/seam/resource/captcha\"/>\n"
@@ -7317,7 +7332,7 @@
 "<h:message for=\"verifyCaptcha\"/>]]>"
 
 #. Tag: para
-#: Security.xml:4175
+#: Security.xml:4187
 #, no-c-format
 msgid ""
 "That's all there is to it. The <literal>graphicImage</literal> control "
@@ -7327,20 +7342,20 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4184
+#: Security.xml:4196
 #, no-c-format
 msgid "Customising the CAPTCHA algorithm"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4186
+#: Security.xml:4198
 #, no-c-format
 msgid ""
 "You may customize the CAPTCHA algorithm by overriding the built-in component:"
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4190
+#: Security.xml:4202
 #, no-c-format
 msgid ""
 "<![CDATA[@Name(\"org.jboss.seam.captcha.captcha\")\n"
@@ -7388,13 +7403,13 @@
 "}]]>"
 
 #. Tag: title
-#: Security.xml:4197 Security.xml:4205
+#: Security.xml:4209 Security.xml:4217
 #, no-c-format
 msgid "Security Events"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4199
+#: Security.xml:4211
 #, no-c-format
 msgid ""
 "The following table describes a number of events (see <xref linkend=\"events"
@@ -7402,68 +7417,68 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4214
+#: Security.xml:4226
 #, no-c-format
 msgid "Event Key"
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4227
+#: Security.xml:4239
 #, no-c-format
 msgid "org.jboss.seam.security.loginSuccessful"
 msgstr "org.jboss.seam.security.loginSuccessful"
 
 #. Tag: para
-#: Security.xml:4231
+#: Security.xml:4243
 #, no-c-format
 msgid "Raised when a login attempt is successful."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4239
+#: Security.xml:4251
 #, no-c-format
 msgid "org.jboss.seam.security.loginFailed"
 msgstr "org.jboss.seam.security.loginFailed"
 
 #. Tag: para
-#: Security.xml:4243
+#: Security.xml:4255
 #, no-c-format
 msgid "Raised when a login attempt fails."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4251
+#: Security.xml:4263
 #, no-c-format
 msgid "org.jboss.seam.security.alreadyLoggedIn"
 msgstr "org.jboss.seam.security.alreadyLoggedIn"
 
 #. Tag: para
-#: Security.xml:4255
+#: Security.xml:4267
 #, no-c-format
 msgid ""
 "Raised when a user that is already authenticated attempts to log in again."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4263
+#: Security.xml:4275
 #, no-c-format
 msgid "org.jboss.seam.security.notLoggedIn"
 msgstr "org.jboss.seam.security.notLoggedIn"
 
 #. Tag: para
-#: Security.xml:4267
+#: Security.xml:4279
 #, no-c-format
 msgid "Raised when a security check fails when the user is not logged in."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4275
+#: Security.xml:4287
 #, no-c-format
 msgid "org.jboss.seam.security.notAuthorized"
 msgstr "org.jboss.seam.security.notAuthorized"
 
 #. Tag: para
-#: Security.xml:4279
+#: Security.xml:4291
 #, no-c-format
 msgid ""
 "Raised when a security check fails when the user is logged in however "
@@ -7471,73 +7486,73 @@
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4287
+#: Security.xml:4299
 #, no-c-format
 msgid "org.jboss.seam.security.preAuthenticate"
 msgstr "org.jboss.seam.security.preAuthenticate"
 
 #. Tag: para
-#: Security.xml:4291
+#: Security.xml:4303
 #, no-c-format
 msgid "Raised just prior to user authentication."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4299
+#: Security.xml:4311
 #, no-c-format
 msgid "org.jboss.seam.security.postAuthenticate"
 msgstr "org.jboss.seam.security.postAuthenticate"
 
 #. Tag: para
-#: Security.xml:4303
+#: Security.xml:4315
 #, no-c-format
 msgid "Raised just after user authentication."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4311
+#: Security.xml:4323
 #, no-c-format
 msgid "org.jboss.seam.security.loggedOut"
 msgstr "org.jboss.seam.security.loggedOut"
 
 #. Tag: para
-#: Security.xml:4315
+#: Security.xml:4327
 #, no-c-format
 msgid "Raised after the user has logged out."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4323
+#: Security.xml:4335
 #, no-c-format
 msgid "org.jboss.seam.security.credentialsUpdated"
 msgstr "org.jboss.seam.security.credentialsUpdated"
 
 #. Tag: para
-#: Security.xml:4327
+#: Security.xml:4339
 #, no-c-format
 msgid "Raised when the user's credentials have been changed."
 msgstr ""
 
 #. Tag: literal
-#: Security.xml:4335
+#: Security.xml:4347
 #, no-c-format
 msgid "org.jboss.seam.security.rememberMe"
 msgstr "org.jboss.seam.security.rememberMe"
 
 #. Tag: para
-#: Security.xml:4339
+#: Security.xml:4351
 #, no-c-format
 msgid "Raised when the Identity's rememberMe property is changed."
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4352
+#: Security.xml:4364
 #, no-c-format
 msgid "Run As"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4354
+#: Security.xml:4366
 #, no-c-format
 msgid ""
 "Sometimes it may be necessary to perform certain operations with elevated "
@@ -7549,7 +7564,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4362
+#: Security.xml:4374
 #, no-c-format
 msgid ""
 "The following code example demonstrates how <literal>RunAsOperation</"
@@ -7560,7 +7575,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4369
+#: Security.xml:4381
 #, no-c-format
 msgid ""
 "<![CDATA[    new RunAsOperation() {       \n"
@@ -7578,7 +7593,7 @@
 "     .run();]]>"
 
 #. Tag: para
-#: Security.xml:4371
+#: Security.xml:4383
 #, no-c-format
 msgid ""
 "In a similar way, the <literal>getPrincipal()</literal> or "
@@ -7589,13 +7604,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4382
+#: Security.xml:4394
 #, no-c-format
 msgid "Extending the Identity component"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4384
+#: Security.xml:4396
 #, no-c-format
 msgid ""
 "Sometimes it might be necessary to extend the Identity component if your "
@@ -7608,7 +7623,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4392
+#: Security.xml:4404
 #, no-c-format
 msgid ""
 "<![CDATA[@Name(\"org.jboss.seam.security.identity\")\n"
@@ -7672,7 +7687,7 @@
 "}]]>"
 
 #. Tag: para
-#: Security.xml:4395
+#: Security.xml:4407
 #, no-c-format
 msgid ""
 "Note that an <literal>Identity</literal> component must be marked "
@@ -7682,13 +7697,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4407
+#: Security.xml:4419
 #, no-c-format
 msgid "OpenID"
 msgstr "OpenID"
 
 #. Tag: para
-#: Security.xml:4409
+#: Security.xml:4421
 #, no-c-format
 msgid ""
 "OpenID is a community standard for external web-based authentication. The "
@@ -7701,7 +7716,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4418
+#: Security.xml:4430
 #, no-c-format
 msgid ""
 "When using OpenID, the user selects an OpenID provider, and the provider "
@@ -7718,7 +7733,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4427
+#: Security.xml:4439
 #, no-c-format
 msgid ""
 "It's important to realize at this point that authentication does not imply "
@@ -7731,13 +7746,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4437
+#: Security.xml:4449
 #, no-c-format
 msgid "Configuring OpenID"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4438
+#: Security.xml:4450
 #, no-c-format
 msgid ""
 "Seam uses the openid4java package and requires four additional JARs to make "
@@ -7747,7 +7762,7 @@
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4444
+#: Security.xml:4456
 #, no-c-format
 msgid ""
 "OpenID processing requires the use of the <literal>OpenIdPhaseListener</"
@@ -7757,7 +7772,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4450
+#: Security.xml:4462
 #, no-c-format
 msgid ""
 "&lt;lifecycle&gt;\n"
@@ -7771,7 +7786,7 @@
 "&lt;/lifecycle&gt;"
 
 #. Tag: para
-#: Security.xml:4453
+#: Security.xml:4465
 #, no-c-format
 msgid ""
 "With this configuration, OpenID support is available to your application. "
@@ -7781,13 +7796,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4461
+#: Security.xml:4473
 #, no-c-format
 msgid "Presenting an OpenIdDLogin form"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4463
+#: Security.xml:4475
 #, no-c-format
 msgid ""
 "To initiate an OpenID login, you can present a simply form to the user "
@@ -7797,7 +7812,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4468
+#: Security.xml:4480
 #, no-c-format
 msgid ""
 "&lt;h:form&gt;\n"
@@ -7813,7 +7828,7 @@
 "&lt;/h:form&gt;"
 
 #. Tag: para
-#: Security.xml:4470
+#: Security.xml:4482
 #, no-c-format
 msgid ""
 "When the user submits the login form, he will be redirected to his OpenID "
@@ -7825,13 +7840,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4479
+#: Security.xml:4491
 #, no-c-format
 msgid "Logging in immediately"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4481
+#: Security.xml:4493
 #, no-c-format
 msgid ""
 "The simplest strategy is to simply login the user immediately. The following "
@@ -7840,7 +7855,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4485
+#: Security.xml:4497
 #, no-c-format
 msgid ""
 "&lt;page view-id=&quot;/openid.xhtml&quot;&gt;\n"
@@ -7874,7 +7889,7 @@
 "&lt;/page&gt;"
 
 #. Tag: para
-#: Security.xml:4487
+#: Security.xml:4499
 #, no-c-format
 msgid ""
 "Thie <literal>loginImmediately()</literal> action checks to see if the "
@@ -7888,13 +7903,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4498
+#: Security.xml:4510
 #, no-c-format
 msgid "Deferring login"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4500
+#: Security.xml:4512
 #, no-c-format
 msgid ""
 "You may not want the user to be immediately logged in to your application. "
@@ -7911,13 +7926,13 @@
 msgstr ""
 
 #. Tag: title
-#: Security.xml:4514
+#: Security.xml:4526
 #, no-c-format
 msgid "Logging out"
 msgstr ""
 
 #. Tag: para
-#: Security.xml:4516
+#: Security.xml:4528
 #, no-c-format
 msgid ""
 "Logging out (forgetting an OpenID association) is done by calling <literal>#"
@@ -7928,7 +7943,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: Security.xml:4523
+#: Security.xml:4535
 #, no-c-format
 msgid ""
 "&lt;event type=&quot;org.jboss.seam.security.loggedOut&quot;&gt;\n"
@@ -7940,7 +7955,7 @@
 "&lt;/event&gt;"
 
 #. Tag: para
-#: Security.xml:4525
+#: Security.xml:4537
 #, no-c-format
 msgid ""
 "It's important that you do not leave this out or the user will not be able "

Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Webservices.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Webservices.po	2009-04-29 11:48:02 UTC (rev 10717)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/it-IT/Webservices.po	2009-04-29 12:53:38 UTC (rev 10718)
@@ -5,8 +5,8 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-03-22 12:51+0000\n"
-"PO-Revision-Date: 2009-03-22 13:57+0100\n"
+"POT-Creation-Date: 2009-04-29 12:40+0000\n"
+"PO-Revision-Date: 2009-04-29 14:52+0100\n"
 "Last-Translator: Nicola Benaglia <nico.benaz at gmail.com>\n"
 "Language-Team: none\n"
 "MIME-Version: 1.0\n"
@@ -491,6 +491,7 @@
 "     <resteasy:resource-class-names>\n"
 "         <value>org.foo.MyCustomerResource</value>\n"
 "         <value>org.foo.MyOrderResource</value>\n"
+"         <value>org.foo.MyStatelessEJBImplementation</value>\n"
 "     </resteasy:resource-class-names>\n"
 "\n"
 "     <resteasy:provider-class-names>\n"
@@ -507,6 +508,7 @@
 "     <resteasy:resource-class-names>\n"
 "         <value>org.foo.MyCustomerResource</value>\n"
 "         <value>org.foo.MyOrderResource</value>\n"
+"         <value>org.foo.MyStatelessEJBImplementation</value>\n"
 "     </resteasy:resource-class-names>\n"
 "\n"
 "     <resteasy:provider-class-names>\n"
@@ -518,17 +520,23 @@
 #. Tag: para
 #: Webservices.xml:259
 #, no-c-format
+msgid "RESTEasy supports plain EJBs (EJBs that are not Seam components) as resources. Instead of configuring the JNDI names in a non-portable fashion in <literal>web.xml</literal> (see RESTEasy documentation), you can simply list the EJB implementation classes, not the business interfaces, in <literal>components.xml</literal> as shown above. Note that you have to annotate the <literal>@Local</literal> interface of the EJB with <literal>@Path</literal>, <literal>@GET</literal>, and so on - not the bean implementation class. This allows you to keep your application deployment-portable with the global Seam <literal>jndi-pattern</literal> switch on <literal>&lt;core:init/&gt;</literal>. Note that EJB resources will not be found even if scanning of resources is enabled, you always have to list them manually. Again, this is only relevant for EJB resources that are not also Seam components and that do not have a <literal>@Name</literal> annotation."
+msgstr ""
+
+#. Tag: para
+#: Webservices.xml:271
+#, no-c-format
 msgid "The <literal>use-built-in-providers</literal> switch enables (default) or disables the RESTEasy built-in providers. We recommend you leave them enabled, as they provide plaintext, JSON, and JAXB marshalling out of the box."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:265
+#: Webservices.xml:277
 #, no-c-format
 msgid "Finally, you can configure media type and language URI extensions:"
 msgstr ""
 
 #. Tag: programlisting
-#: Webservices.xml:269
+#: Webservices.xml:281
 #, no-c-format
 msgid ""
 "<![CDATA[<resteasy:application>\n"
@@ -556,31 +564,31 @@
 "</resteasy:application>]]>"
 
 #. Tag: para
-#: Webservices.xml:271
+#: Webservices.xml:283
 #, no-c-format
 msgid "This definition would map the URI suffix of <literal>.txt.deutsch</literal> to additional <literal>Accept</literal> and <literal>Accept-Language</literal> header values <literal>text/plain</literal> and <literal>de-DE</literal>."
 msgstr ""
 
 #. Tag: title
-#: Webservices.xml:280
+#: Webservices.xml:292
 #, no-c-format
 msgid "Resources and providers as Seam components"
 msgstr "Risorse e provider come componenti Seam"
 
 #. Tag: para
-#: Webservices.xml:282
+#: Webservices.xml:294
 #, no-c-format
 msgid "Any resource and provider instances are managed by RESTEasy by default. That means a resource class will be instantiated by RESTEasy and serve a single request, after which it will be destroyed. This is the default JAX-RS lifecycle. Providers are instantiated once for the whole application and are effectively singletons and supposed to be stateless."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:289
+#: Webservices.xml:301
 #, no-c-format
 msgid "You can write resources and providers as Seam components and benefit from the richer lifecycle management of Seam, and interception for bijection, security, and so on. Simply make your resource class a Seam component:"
 msgstr ""
 
 #. Tag: programlisting
-#: Webservices.xml:295
+#: Webservices.xml:307
 #, no-c-format
 msgid ""
 "<![CDATA[@Name(\"customerResource\")\n"
@@ -616,49 +624,49 @@
 "}]]>"
 
 #. Tag: para
-#: Webservices.xml:297
+#: Webservices.xml:309
 #, no-c-format
 msgid "An instance of <literal>customerResource</literal> is now handled by Seam when a request hits the server. This is a Seam JavaBean component that is <literal>EVENT</literal>-scoped, hence no different than the default JAX-RS lifecycle. However, you get full Seam injection support and all other Seam components and contexts are available to you. Currently also supported are <literal>SESSION</literal>, <literal>APPLICATION</literal>, and <literal>STATELESS</literal> resource components. Remember that any HTTP request has to transmit a valid session identifier (cookie, URI path parameter) for correct handling of the server-side session context."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:307
+#: Webservices.xml:319
 #, no-c-format
 msgid "Conversation-scoped resource components and mapping of conversations is currently not supported but will be available soon."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:312
+#: Webservices.xml:324
 #, no-c-format
 msgid "Provider classes can also be Seam components, they must be <literal>APPLICATION</literal>-scoped or <literal>STATELESS</literal>."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:317
+#: Webservices.xml:329
 #, no-c-format
 msgid "Resources and providers can be EJBs or JavaBeans, like any other Seam component."
 msgstr ""
 
 #. Tag: title
-#: Webservices.xml:324
+#: Webservices.xml:336
 #, no-c-format
 msgid "Mapping exceptions to HTTP responses"
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:326
+#: Webservices.xml:338
 #, no-c-format
 msgid "Section 3.3.4 of the JAX-RS specification defines how checked or unchecked exceptions are handled by the JAX RS implementation. In addition to using an exception mapping provider as defined by JAX-RS, the integration of RESTEasy with Seam allows you to map exceptions to HTTP response codes within Seam's <literal>pages.xml</literal> facility. If you are already using <literal>pages.xml</literal> declarations, this is easier to maintain than potentially many JAX RS exception mapper classes."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:334
+#: Webservices.xml:346
 #, no-c-format
 msgid "Exception handling within Seam requires that the Seam filter is executed for your HTTP request. Ensure that you do filter <emphasis>all</emphasis> requests in your <literal>web.xml</literal>, not - as some Seam examples might show - a request URI pattern that doesn't cover your REST requests. The following example intercepts <emphasis>all</emphasis> HTTP requests and enables Seam exception handling:"
 msgstr ""
 
 #. Tag: programlisting
-#: Webservices.xml:341
+#: Webservices.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<filter>\n"
@@ -671,15 +679,24 @@
 "    <url-pattern>/*</url-pattern>\n"
 "</filter-mapping>]]>"
 msgstr ""
+"<![CDATA[<filter>\n"
+"    <filter-name>Seam Filter</filter-name>\n"
+"    <filter-class>org.jboss.seam.servlet.SeamFilter</filter-class>\n"
+"</filter>\n"
+"\n"
+"<filter-mapping>\n"
+"    <filter-name>Seam Filter</filter-name>\n"
+"    <url-pattern>/*</url-pattern>\n"
+"</filter-mapping>]]>"
 
 #. Tag: para
-#: Webservices.xml:343
+#: Webservices.xml:355
 #, no-c-format
 msgid "To convert the unchecked <literal>UnsupportedOperationException</literal> thrown by your resource methods to a <literal>501 Not Implemented</literal> HTTP status response, add the following to your <literal>pages.xml</literal> descriptor:"
 msgstr ""
 
 #. Tag: programlisting
-#: Webservices.xml:349
+#: Webservices.xml:361
 #, no-c-format
 msgid ""
 "<![CDATA[<exception class=\"java.lang.UnsupportedOperationException\">\n"
@@ -695,13 +712,13 @@
 "</exception>]]>"
 
 #. Tag: para
-#: Webservices.xml:351
+#: Webservices.xml:363
 #, no-c-format
 msgid "Custom or checked exceptions are handled the same:"
 msgstr ""
 
 #. Tag: programlisting
-#: Webservices.xml:355
+#: Webservices.xml:367
 #, no-c-format
 msgid ""
 "<![CDATA[<exception class=\"my.CustomException\" log=\"false\">\n"
@@ -717,13 +734,13 @@
 "</exception>]]>"
 
 #. Tag: para
-#: Webservices.xml:357
+#: Webservices.xml:369
 #, no-c-format
 msgid "You do not have to send an HTTP error to the client if an exception occurs. Seam allows you to map the exception as a redirect to a view of your Seam application. As this feature is typically used for human clients (web browsers) and not for REST API remote clients, you should pay extra attention to conflicting exception mappings in <literal>pages.xml</literal>."
 msgstr ""
 
 #. Tag: para
-#: Webservices.xml:364
+#: Webservices.xml:376
 #, no-c-format
 msgid "Note that the HTTP response still passes through the servlet container, so an additional mapping might apply if you have <literal>&lt;error-page&gt;</literal> mappings in your <literal>web.xml</literal> configuration. The HTTP status code would then be mapped to a rendered HTML error page with status <literal>200 OK</literal>!"
 msgstr ""




More information about the seam-commits mailing list