[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.<name></literal> event (where <literal><name></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.<name></literal> event (where <literal><name></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.<name></literal> (dove <literal><name></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<Permission>"
msgstr "List<Permission>"
#. 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<Object> targets, String action)"
msgstr "listPermissions(Set<Object> 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<Permission> permissions)"
msgstr "grantPermissions(List<Permission> 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<Permission> permissions)"
msgstr "revokePermissions(List<Permission> 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<String>"
msgstr "List<String>"
#. 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 ""
"<lifecycle>\n"
@@ -7771,7 +7786,7 @@
"</lifecycle>"
#. 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 ""
"<h:form>\n"
@@ -7813,7 +7828,7 @@
"</h:form>"
#. 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 ""
"<page view-id="/openid.xhtml">\n"
@@ -7874,7 +7889,7 @@
"</page>"
#. 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 ""
"<event type="org.jboss.seam.security.loggedOut">\n"
@@ -7940,7 +7955,7 @@
"</event>"
#. 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><core:init/></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><error-page></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