# Language ja-JP translations for PACKAGE package.
# Automatically generated, 2008.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
"POT-Creation-Date: 2008-04-04 01:24+0000\n"
"PO-Revision-Date: 2008-04-04 01:24+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. Tag: title
#: Annotations.xml:5
#, no-c-format
msgid "Seam annotations"
msgstr ""

#. Tag: para
#: Annotations.xml:7
#, no-c-format
msgid ""
"When you write a Seam application, you'll use a lot of annotations. Seam "
"lets you use annotations to achieve a declarative style of programming. Most "
"of the annotations you'll use are defined by the EJB 3.0 specification. The "
"annotations for data validation are defined by the Hibernate Validator "
"package. Finally, Seam defines its own set of annotations, which we'll "
"describe in this chapter."
msgstr ""

#. Tag: para
#: Annotations.xml:16
#, no-c-format
msgid ""
"All of these annotations are defined in the package <literal>org.jboss.seam."
"annotations</literal>."
msgstr ""

#. Tag: title
#: Annotations.xml:22
#, no-c-format
msgid "Annotations for component definition"
msgstr ""

#. Tag: para
#: Annotations.xml:23
#, no-c-format
msgid ""
"The first group of annotations lets you define a Seam component. These "
"annotations appear on the component class."
msgstr ""

#. Tag: literal
#: Annotations.xml:31
#, no-c-format
msgid "@Name"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:34
#, no-c-format
msgid "<![CDATA[@Name(\"componentName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:35
#, no-c-format
msgid ""
"Defines the Seam component name for a class. This annotation is required for "
"all Seam components."
msgstr ""

#. Tag: literal
#: Annotations.xml:43
#, no-c-format
msgid "@Scope"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:46
#, no-c-format
msgid "<![CDATA[@Scope(ScopeType.CONVERSATION)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:47
#, no-c-format
msgid ""
"Defines the default context of the component. The possible values are "
"defined by the <literal>ScopeType</literal> enumeration: <literal>EVENT, "
"PAGE, CONVERSATION, SESSION, BUSINESS_PROCESS, APPLICATION, STATELESS</"
"literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:52
#, no-c-format
msgid ""
"When no scope is explicitly specified, the default depends upon the "
"component type. For stateless session beans, the default is "
"<literal>STATELESS</literal>. For entity beans and stateful session beans, "
"the default is <literal>CONVERSATION</literal>. For JavaBeans, the default "
"is <literal>EVENT</literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:64
#, no-c-format
msgid "@Role"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:67
#, no-c-format
msgid "<![CDATA[@Role(name=\"roleName\", scope=ScopeType.SESSION)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:68
#, no-c-format
msgid ""
"Allows a Seam component to be bound to multiple contexts variables. The "
"<literal>@Name</literal>/<literal>@Scope</literal> annotations define a "
"\"default role\". Each <literal>@Role</literal> annotation defines an "
"additional role."
msgstr ""

#. Tag: para
#: Annotations.xml:76
#, no-c-format
msgid "<literal>name</literal> &#8212; the context variable name."
msgstr ""

#. Tag: para
#: Annotations.xml:82
#, no-c-format
msgid ""
"<literal>scope</literal> &#8212; the context variable scope. When no scope "
"is explicitly specified, the default depends upon the component type, as "
"above."
msgstr ""

#. Tag: literal
#: Annotations.xml:93
#, no-c-format
msgid "@Roles"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:96
#, no-c-format
msgid ""
"<![CDATA[@Roles({\n"
"        @Role(name=\"user\", scope=ScopeType.CONVERSATION),\n"
"        @Role(name=\"currentUser\", scope=ScopeType.SESSION)\n"
"   })]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:97
#, no-c-format
msgid "Allows specification of multiple additional roles."
msgstr ""

#. Tag: literal
#: Annotations.xml:104
#, no-c-format
msgid "@BypassInterceptors"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:107
#, no-c-format
msgid "<![CDATA[@BypassInterceptors]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:108
#, no-c-format
msgid ""
"Disables Seam all interceptors on a particular component or method of a "
"component."
msgstr ""

#. Tag: literal
#: Annotations.xml:116
#, no-c-format
msgid "@JndiName"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:119
#, no-c-format
msgid "<![CDATA[@JndiName(\"my/jndi/name\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:120
#, no-c-format
msgid ""
"Specifies the JNDI name that Seam will use to look up the EJB component. If "
"no JNDI name is explicitly specified, Seam will use the JNDI pattern "
"specified by <literal>org.jboss.seam.core.init.jndiPattern</literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:130
#, no-c-format
msgid "@Conversational"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:133
#, no-c-format
msgid "<![CDATA[@Conversational]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:134
#, no-c-format
msgid ""
"Specifies that a conversation scope component is conversational, meaning "
"that no method of the component may be called unless a long-running "
"conversation is active."
msgstr ""

#. Tag: literal
#: Annotations.xml:143
#, no-c-format
msgid "@PerNestedConversation"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:146
#, no-c-format
msgid "<![CDATA[@PerNestedConversation]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:147
#, no-c-format
msgid ""
"Limits the scope of a CONVERSATION-scoped component to just the parent "
"conversation in which it was instantiated. The component instance will not "
"be visible to nested child conversations, which will get their own instance."
msgstr ""

#. Tag: para
#: Annotations.xml:153
#, no-c-format
msgid ""
"Warning: this is ill-defined, since it implies that a component will be "
"visible for some part of a request cycle, and invisible after that. It is "
"not recommended that applications use this feature!"
msgstr ""

#. Tag: literal
#: Annotations.xml:163
#, no-c-format
msgid "@Startup"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:166
#, no-c-format
msgid ""
"<![CDATA[@Scope(APPLICATION) @Startup(depends=\"org.jboss.seam.bpm.jbpm\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:167
#, no-c-format
msgid ""
"Specifies that an application scope component is started immediately at "
"initialization time. This is mainly used for certain built-in components "
"that bootstrap critical infrastructure such as JNDI, datasources, etc."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:173
#, no-c-format
msgid "<![CDATA[@Scope(SESSION) @Startup]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:174
#, no-c-format
msgid ""
"Specifies that a session scope component is started immediately at session "
"creation time."
msgstr ""

#. Tag: para
#: Annotations.xml:180
#, no-c-format
msgid ""
"<literal>depends</literal> &#8212; specifies that the named components must "
"be started first, if they are installed."
msgstr ""

#. Tag: literal
#: Annotations.xml:191
#, no-c-format
msgid "@Install"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:194
#, no-c-format
msgid "<![CDATA[@Install(false)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:195
#, no-c-format
msgid ""
"Specifies whether or not a component should be installed by default. The "
"lack of an <literal>@Install</literal> annotation indicates a component "
"should be installed."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:200
#, no-c-format
msgid "<![CDATA[@Install(dependencies=\"org.jboss.seam.bpm.jbpm\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:201
#, no-c-format
msgid ""
"Specifies that a component should only be stalled if the components listed "
"as dependencies are also installed."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:205
#, no-c-format
msgid "<![CDATA[@Install(genericDependencies=ManagedQueueSender.class)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:206
#, no-c-format
msgid ""
"Specifies that a component should only be installed if a component that is "
"implemented by a certain class is installed. This is useful when the "
"dependency doesn't have a single well-known name."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:212
#, no-c-format
msgid "<![CDATA[@Install(classDependencies=\"org.hibernate.Session\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:213
#, no-c-format
msgid ""
"Specifies that a component should only be installed if the named class is in "
"the classpath."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:217
#, no-c-format
msgid "<![CDATA[@Install(precedence=BUILT_IN)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:218
#, no-c-format
msgid ""
"Specifies the precedence of the component. If multiple components with the "
"same name exist, the one with the higher precedence will be installed. The "
"defined precendence values are (in ascending order):"
msgstr ""

#. Tag: para
#: Annotations.xml:227
#, no-c-format
msgid ""
"<literal>BUILT_IN</literal> &#8212; Precedence of all built-in Seam "
"components"
msgstr ""

#. Tag: para
#: Annotations.xml:233
#, no-c-format
msgid ""
"<literal>FRAMEWORK</literal> &#8212; Precedence to use for components of "
"frameworks which extend Seam"
msgstr ""

#. Tag: para
#: Annotations.xml:239
#, no-c-format
msgid ""
"<literal>APPLICATION</literal> &#8212; Predence of application components "
"(the default precedence)"
msgstr ""

#. Tag: para
#: Annotations.xml:245
#, no-c-format
msgid ""
"<literal>DEPLOYMENT</literal> &#8212; Precedence to use for components which "
"override application components in a particular deployment"
msgstr ""

#. Tag: para
#: Annotations.xml:252
#, no-c-format
msgid ""
"<literal>MOCK</literal> &#8212; Precedence for mock objects used in testing"
msgstr ""

#. Tag: literal
#: Annotations.xml:263
#, no-c-format
msgid "@Synchronized"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:266
#, no-c-format
msgid "<![CDATA[@Synchronized(timeout=1000)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:267
#, no-c-format
msgid ""
"Specifies that a component is accessed concurrently by multiple clients, and "
"that Seam should serialize requests. If a request is not able to obtain its "
"lock on the component in the given timeout period, an exception will be "
"raised."
msgstr ""

#. Tag: literal
#: Annotations.xml:277
#, no-c-format
msgid "@ReadOnly"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:280
#, no-c-format
msgid "<![CDATA[@ReadOnly]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:281
#, no-c-format
msgid ""
"Specifies that a JavaBean component or component method does not require "
"state replication at the end of the invocation."
msgstr ""

#. Tag: literal
#: Annotations.xml:289
#, no-c-format
msgid "@AutoCreate"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:292
#, no-c-format
msgid "<![CDATA[@AutoCreate]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:293
#, no-c-format
msgid ""
"Specifies that a component will be automatically created, even if the client "
"does not specify <literal>create=true</literal>."
msgstr ""

#. Tag: title
#: Annotations.xml:303
#, no-c-format
msgid "Annotations for bijection"
msgstr ""

#. Tag: para
#: Annotations.xml:304
#, no-c-format
msgid ""
"The next two annotations control bijection. These attributes occur on "
"component instance variables or property accessor methods."
msgstr ""

#. Tag: literal
#: Annotations.xml:312
#, no-c-format
msgid "<literal>@In</literal>"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:315
#, no-c-format
msgid "<![CDATA[@In]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:316
#, no-c-format
msgid ""
"Specifies that a component attribute is to be injected from a context "
"variable at the beginning of each component invocation. If the context "
"variable is null, an exception will be thrown."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:322
#, no-c-format
msgid "<![CDATA[@In(required=false)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:323
#, no-c-format
msgid ""
"Specifies that a component attribute is to be injected from a context "
"variable at the beginning of each component invocation. The context variable "
"may be null."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:328
#, no-c-format
msgid "<![CDATA[@In(create=true)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:329
#, no-c-format
msgid ""
"Specifies that a component attribute is to be injected from a context "
"variable at the beginning of each component invocation. If the context "
"variable is null, an instance of the component is instantiated by Seam."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:335
#, no-c-format
msgid "<![CDATA[@In(value=\"contextVariableName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:336 Annotations.xml:403
#, no-c-format
msgid ""
"Specifies the name of the context variable explicitly, instead of using the "
"annotated instance variable name."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:340
#, no-c-format
msgid "<![CDATA[@In(value=\"#{customer.addresses['shipping']}\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:341
#, no-c-format
msgid ""
"Specifies that a component attribute is to be injected by evaluating a JSF "
"EL expression at the beginning of each component invocation."
msgstr ""

#. Tag: para
#: Annotations.xml:348
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; specifies the name of the context variable. "
"Default to the name of the component attribute. Alternatively, specifies a "
"JSF EL expression, surrounded by <literal>#{...}</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:356
#, no-c-format
msgid ""
"<literal>create</literal> &#8212; specifies that Seam should instantiate the "
"component with the same name as the context variable if the context variable "
"is undefined (null) in all contexts. Default to false."
msgstr ""

#. Tag: para
#: Annotations.xml:364
#, no-c-format
msgid ""
"<literal>required</literal> &#8212; specifies Seam should throw an exception "
"if the context variable is undefined in all contexts."
msgstr ""

#. Tag: literal
#: Annotations.xml:375
#, no-c-format
msgid "@Out"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:378
#, no-c-format
msgid "<![CDATA[@Out]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:379
#, no-c-format
msgid ""
"Specifies that a component attribute that is a Seam component is to be "
"outjected to its context variable at the end of the invocation. If the "
"attribute is null, an exception is thrown."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:384
#, no-c-format
msgid "<![CDATA[@Out(required=false)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:385
#, no-c-format
msgid ""
"Specifies that a component attribute that is a Seam component is to be "
"outjected to its context variable at the end of the invocation. The "
"attribute may be null."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:390
#, no-c-format
msgid "<![CDATA[@Out(scope=ScopeType.SESSION)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:391
#, no-c-format
msgid ""
"Specifies that a component attribute that is <emphasis>not</emphasis> a Seam "
"component type is to be outjected to a specific scope at the end of the "
"invocation."
msgstr ""

#. Tag: para
#: Annotations.xml:396
#, no-c-format
msgid ""
"Alternatively, if no scope is explicitly specified, the scope of the "
"component with the <literal>@Out</literal> attribute is used (or the "
"<literal>EVENT</literal> scope if the component is stateless)."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:402
#, no-c-format
msgid "<![CDATA[@Out(value=\"contextVariableName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:409
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; specifies the name of the context variable. "
"Default to the name of the component attribute."
msgstr ""

#. Tag: para
#: Annotations.xml:416
#, no-c-format
msgid ""
"<literal>required</literal> &#8212; specifies Seam should throw an exception "
"if the component attribute is null during outjection."
msgstr ""

#. Tag: para
#: Annotations.xml:427
#, no-c-format
msgid ""
"Note that it is quite common for these annotations to occur together, for "
"example:"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:432
#, no-c-format
msgid "<![CDATA[@In(create=true) @Out private User currentUser;]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:434
#, no-c-format
msgid ""
"The next annotation supports the <emphasis>manager component</emphasis> "
"pattern, where a Seam component that manages the lifecycle of an instance of "
"some other class that is to be injected. It appears on a component getter "
"method."
msgstr ""

#. Tag: literal
#: Annotations.xml:444
#, no-c-format
msgid "@Unwrap"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:447
#, no-c-format
msgid "<![CDATA[@Unwrap]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:448
#, no-c-format
msgid ""
"Specifies that the object returned by the annotated getter method is the "
"thing that is injected instead of the component instance itself."
msgstr ""

#. Tag: para
#: Annotations.xml:457
#, no-c-format
msgid ""
"The next annotation supports the <emphasis>factory component</emphasis> "
"pattern, where a Seam component is responsible for initializing the value of "
"a context variable. This is especially useful for initializing any state "
"needed for rendering the response to a non-faces request. It appears on a "
"component method."
msgstr ""

#. Tag: literal
#: Annotations.xml:468
#, no-c-format
msgid "@Factory"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:471
#, no-c-format
msgid ""
"<![CDATA[@Factory(\"processInstance\") public void createProcessInstance() "
"{ ... }]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:472
#, no-c-format
msgid ""
"Specifies that the method of the component is used to initialize the value "
"of the named context variable, when the context variable has no value. This "
"style is used with methods that return <literal>void</literal>."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:478
#, no-c-format
msgid ""
"<![CDATA[@Factory(\"processInstance\", scope=CONVERSATION) public "
"ProcessInstance createProcessInstance() { ... }]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:479
#, no-c-format
msgid ""
"Specifies that the method returns a value that Seam should use to initialize "
"the value of the named context variable, when the context variable has no "
"value. This style is used with methods that return a value. If no scope is "
"explicitly specified, the scope of the component with the <literal>@Factory</"
"literal> method is used (unless the component is stateless, in which case "
"the <literal>EVENT</literal> context is used)."
msgstr ""

#. Tag: para
#: Annotations.xml:491
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; specifies the name of the context variable. "
"If the method is a getter method, default to the JavaBeans property name."
msgstr ""

#. Tag: para
#: Annotations.xml:498
#, no-c-format
msgid ""
"<literal>scope</literal> &#8212; specifies the scope that Seam should bind "
"the returned value to. Only meaningful for factory methods which return a "
"value."
msgstr ""

#. Tag: para
#: Annotations.xml:505
#, no-c-format
msgid ""
"<literal>autoCreate</literal> &#8212; specifies that this factory method "
"should be automatically called whenever the variable is asked for, even if "
"<literal>@In</literal> does not specify <literal>create=true</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:518
#, no-c-format
msgid "This annotation lets you inject a <literal>Log</literal>:"
msgstr ""

#. Tag: literal
#: Annotations.xml:525
#, no-c-format
msgid "@Logger"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:528
#, no-c-format
msgid "<![CDATA[@Logger(\"categoryName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:529
#, no-c-format
msgid ""
"Specifies that a component field is to be injected with an instance of "
"<literal>org.jboss.seam.log.Log</literal>. For entity beans, the field must "
"be declared as static."
msgstr ""

#. Tag: para
#: Annotations.xml:536
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; specifies the name of the log category. "
"Default to the name of the component class."
msgstr ""

#. Tag: para
#: Annotations.xml:547
#, no-c-format
msgid "The last annotation lets you inject a request parameter value:"
msgstr ""

#. Tag: literal
#: Annotations.xml:554
#, no-c-format
msgid "@RequestParameter"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:557
#, no-c-format
msgid "<![CDATA[@RequestParameter(\"parameterName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:558
#, no-c-format
msgid ""
"Specifies that a component attribute is to be injected with the value of a "
"request parameter. Basic type conversions are performed automatically."
msgstr ""

#. Tag: para
#: Annotations.xml:565
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; specifies the name of the request "
"parameter. Default to the name of the component attribute."
msgstr ""

#. Tag: title
#: Annotations.xml:579
#, no-c-format
msgid "Annotations for component lifecycle methods"
msgstr ""

#. Tag: para
#: Annotations.xml:580
#, no-c-format
msgid ""
"These annotations allow a component to react to its own lifecycle events. "
"They occur on methods of the component. There may be only one of each per "
"component class."
msgstr ""

#. Tag: literal
#: Annotations.xml:589
#, no-c-format
msgid "@Create"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:592
#, no-c-format
msgid "<![CDATA[@Create]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:593
#, no-c-format
msgid ""
"Specifies that the method should be called when an instance of the component "
"is instantiated by Seam. Note that create methods are only supported for "
"JavaBeans and stateful session beans."
msgstr ""

#. Tag: literal
#: Annotations.xml:603
#, no-c-format
msgid "@Destroy"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:606
#, no-c-format
msgid "<![CDATA[@Destroy]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:607
#, no-c-format
msgid ""
"Specifies that the method should be called when the context ends and its "
"context variables are destroyed. Note that destroy methods are only "
"supported for JavaBeans and stateful session beans."
msgstr ""

#. Tag: para
#: Annotations.xml:613
#, no-c-format
msgid ""
"Destroy methods should be used only for cleanup. <emphasis>Seam catches, "
"logs and swallows any exception that propagates out of a destroy method.</"
"emphasis>"
msgstr ""

#. Tag: literal
#: Annotations.xml:622
#, no-c-format
msgid "@Observer"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:625
#, no-c-format
msgid "<![CDATA[@Observer(\"somethingChanged\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:626
#, no-c-format
msgid ""
"Specifies that the method should be called when a component-driven event of "
"the specified type occurs."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:630
#, no-c-format
msgid "<![CDATA[@Observer(value=\"somethingChanged\",create=false)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:631
#, no-c-format
msgid ""
"Specifies that the method should be called when an event of the specified "
"type occurs but that an instance should not be created if one doesn't exist. "
"If an instance does not exist and create is false, the event will not be "
"observed. The default value for create is true."
msgstr ""

#. Tag: title
#: Annotations.xml:645
#, no-c-format
msgid "Annotations for context demarcation"
msgstr ""

#. Tag: para
#: Annotations.xml:646
#, no-c-format
msgid ""
"These annotations provide declarative conversation demarcation. They appear "
"on methods of Seam components, usually action listener methods."
msgstr ""

#. Tag: para
#: Annotations.xml:651
#, no-c-format
msgid ""
"Every web request has a conversation context associated with it. Most of "
"these conversations end at the end of the request. If you want a "
"conversation that span multiple requests, you must \"promote\" the current "
"conversation to a <emphasis>long-running conversation</emphasis> by calling "
"a method marked with <literal>@Begin</literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:662
#, no-c-format
msgid "@Begin"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:665
#, no-c-format
msgid "<![CDATA[@Begin]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:666
#, no-c-format
msgid ""
"Specifies that a long-running conversation begins when this method returns a "
"non-null outcome without exception."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:670
#, no-c-format
msgid "<![CDATA[@Begin(join=true)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:671
#, no-c-format
msgid ""
"Specifies that if a long-running conversation is already in progress, the "
"conversation context is simply propagated."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:675
#, no-c-format
msgid "<![CDATA[@Begin(nested=true)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:676
#, no-c-format
msgid ""
"Specifies that if a long-running conversation is already in progress, a new "
"<emphasis>nested</emphasis> conversation context begins. The nested "
"conversation will end when the next <literal>@End</literal> is encountered, "
"and the outer conversation will resume. It is perfectly legal for multiple "
"nested conversations to exist concurrently in the same outer conversation."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:685
#, no-c-format
msgid "<![CDATA[@Begin(pageflow=\"process definition name\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:686
#, no-c-format
msgid ""
"Specifies a jBPM process definition name that defines the pageflow for this "
"conversation."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:690
#, no-c-format
msgid "<![CDATA[@Begin(flushMode=FlushModeType.MANUAL)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:691
#, no-c-format
msgid ""
"Specify the flush mode of any Seam-managed persistence contexts. "
"<literal>flushMode=FlushModeType.MANUAL</literal> supports the use of "
"<emphasis>atomic conversations</emphasis> where all write operations are "
"queued in the conversation context until an explicit call to <literal>flush()"
"</literal> (which usually occurs at the end of the conversation)."
msgstr ""

#. Tag: para
#: Annotations.xml:702
#, no-c-format
msgid ""
"<literal>join</literal> &#8212; determines the behavior when a long-running "
"conversation is already in progress. If <literal>true</literal>, the context "
"is propagated. If <literal>false</literal>, an exception is thrown. Default "
"to <literal>false</literal>. This setting is ignored when "
"<literal>nested=true</literal> is specified."
msgstr ""

#. Tag: para
#: Annotations.xml:713
#, no-c-format
msgid ""
"<literal>nested</literal> &#8212; specifies that a nested conversation "
"should be started if a long-running conversation is already in progress."
msgstr ""

#. Tag: para
#: Annotations.xml:720 Annotations.xml:800 Annotations.xml:847
#, no-c-format
msgid ""
"<literal>flushMode</literal> &#8212; set the flush mode of any Seam-managed "
"Hibernate sessions or JPA persistence contexts that are created during this "
"conversation."
msgstr ""

#. Tag: para
#: Annotations.xml:728
#, no-c-format
msgid ""
"<literal>pageflow</literal> &#8212; a process definition name of a jBPM "
"process definition deployed via <literal>org.jboss.seam.bpm.jbpm."
"pageflowDefinitions.</literal>"
msgstr ""

#. Tag: literal
#: Annotations.xml:739
#, no-c-format
msgid "@End"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:742
#, no-c-format
msgid "<![CDATA[@End]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:743
#, no-c-format
msgid ""
"Specifies that a long-running conversation ends when this method returns a "
"non-null outcome without exception."
msgstr ""

#. Tag: para
#: Annotations.xml:749 Annotations.xml:885
#, no-c-format
msgid ""
"<literal>beforeRedirect</literal> &#8212; by default, the conversation will "
"not actually be destroyed until after any redirect has occurred. Setting "
"<literal>beforeRedirect=true</literal> specifies that the conversation "
"should be destroyed at the end of the current request, and that the redirect "
"will be processed in a new temporary conversation context."
msgstr ""

#. Tag: literal
#: Annotations.xml:764
#, no-c-format
msgid "@StartTask"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:767
#, no-c-format
msgid "<![CDATA[@StartTask]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:768
#, no-c-format
msgid ""
"\"Starts\" a jBPM task. Specifies that a long-running conversation begins "
"when this method returns a non-null outcome without exception. This "
"conversation is associated with the jBPM task specified in the named request "
"parameter. Within the context of this conversation, a business process "
"context is also defined, for the business process instance of the task "
"instance."
msgstr ""

#. Tag: para
#: Annotations.xml:779
#, no-c-format
msgid ""
"The jBPM <literal>TaskInstance</literal> will be available in a request "
"context variable named <literal>taskInstance</literal>. The jPBM "
"<literal>ProcessInstance</literal> will be available in a request context "
"variable named <literal>processInstance</literal>. (Of course, these objects "
"are available for injection via <literal>@In</literal>.)"
msgstr ""

#. Tag: para
#: Annotations.xml:791 Annotations.xml:838
#, no-c-format
msgid ""
"<literal>taskIdParameter</literal> &#8212; the name of a request parameter "
"which holds the id of the task. Default to <literal>\"taskId\"</literal>, "
"which is also the default used by the Seam <literal>taskList</literal> JSF "
"component."
msgstr ""

#. Tag: literal
#: Annotations.xml:813
#, no-c-format
msgid "@BeginTask"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:816
#, no-c-format
msgid "<![CDATA[@BeginTask]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:817
#, no-c-format
msgid ""
"Resumes work on an incomplete jBPM task. Specifies that a long-running "
"conversation begins when this method returns a non-null outcome without "
"exception. This conversation is associated with the jBPM task specified in "
"the named request parameter. Within the context of this conversation, a "
"business process context is also defined, for the business process instance "
"of the task instance."
msgstr ""

#. Tag: para
#: Annotations.xml:828
#, no-c-format
msgid ""
"The jBPM <literal>org.jbpm.taskmgmt.exe.TaskInstance</literal> will be "
"available in a request context variable named <literal>taskInstance</"
"literal>. The jPBM <literal>org.jbpm.graph.exe.ProcessInstance</literal> "
"will be available in a request context variable named "
"<literal>processInstance</literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:859
#, no-c-format
msgid "@EndTask"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:862
#, no-c-format
msgid "<![CDATA[@EndTask]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:863
#, no-c-format
msgid ""
"\"Ends\" a jBPM task. Specifies that a long-running conversation ends when "
"this method returns a non-null outcome, and that the current task is "
"complete. Triggers a jBPM transition. The actual transition triggered will "
"be the default transition unless the application has called "
"<literal>Transition.setName()</literal> on the built-in component named "
"<literal>transition</literal>."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:872
#, no-c-format
msgid "<![CDATA[@EndTask(transition=\"transitionName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:873
#, no-c-format
msgid "Triggers the given jBPM transition."
msgstr ""

#. Tag: para
#: Annotations.xml:878
#, no-c-format
msgid ""
"<literal>transition</literal> &#8212; the name of the jBPM transition to be "
"triggered when ending the task. Defaults to the default transition."
msgstr ""

#. Tag: literal
#: Annotations.xml:900
#, no-c-format
msgid "@CreateProcess"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:903
#, no-c-format
msgid "<![CDATA[@CreateProcess(definition=\"process definition name\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:904
#, no-c-format
msgid ""
"Creates a new jBPM process instance when the method returns a non-null "
"outcome without exception. The <literal>ProcessInstance</literal> object "
"will be available in a context variable named <literal>processInstance</"
"literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:913
#, no-c-format
msgid ""
"<literal>definition</literal> &#8212; the name of the jBPM process "
"definition deployed via <literal>org.jboss.seam.bpm.jbpm.processDefinitions</"
"literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:924
#, no-c-format
msgid "@ResumeProcess"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:927
#, no-c-format
msgid "<![CDATA[@ResumeProcess(processIdParameter=\"processId\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:928
#, no-c-format
msgid ""
"Re-enters the scope of an existing jBPM process instance when the method "
"returns a non-null outcome without exception. The <literal>ProcessInstance</"
"literal> object will be available in a context variable named "
"<literal>processInstance</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:937
#, no-c-format
msgid ""
"<literal>processIdParameter</literal> &#8212; the name a request parameter "
"holding the process id. Default to <literal>\"processId\"</literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:949
#, no-c-format
msgid "@Transition"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:952
#, no-c-format
msgid "<![CDATA[@Transition(\"cancel\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:953
#, no-c-format
msgid ""
"Marks a method as signalling a transition in the current jBPM process "
"instance whenever the method returns a non-null result."
msgstr ""

#. Tag: title
#: Annotations.xml:964
#, no-c-format
msgid "Annotations for use with Seam JavaBean components in a J2EE environment"
msgstr ""

#. Tag: para
#: Annotations.xml:965
#, no-c-format
msgid ""
"Seam provides an annotation that lets you force a rollback of the JTA "
"transaction for certain action listener outcomes."
msgstr ""

#. Tag: literal
#: Annotations.xml:973
#, no-c-format
msgid "@Transactional"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:976
#, no-c-format
msgid "<![CDATA[@Transactional]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:977
#, no-c-format
msgid ""
"Specifies that a JavaBean component should have a similar transactional "
"behavior to the default behavior of a session bean component. ie. method "
"invocations should take place in a transaction, and if no transaction exists "
"when the method is called, a transaction will be started just for that "
"method. This annotation may be applied at either class or method level."
msgstr ""

#. Tag: emphasis
#: Annotations.xml:986
#, no-c-format
msgid ""
"Do not use this annotation on EJB 3.0 components, use "
"<literal>@TransactionAttribute</literal>!"
msgstr ""

#. Tag: literal
#: Annotations.xml:993
#, no-c-format
msgid "@ApplicationException"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:996
#, no-c-format
msgid "<![CDATA[@ApplicationException]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:997
#, no-c-format
msgid ""
"Synonym for javax.ejb.ApplicationException, for use in a pre Java EE 5 "
"environment. Applied to an exception to denote that it is an application "
"exception and should be reported to the client directly(i.e., unwrapped)."
msgstr ""

#. Tag: para
#: Annotations.xml:1003
#, no-c-format
msgid ""
"<emphasis>Do not use this annotation on EJB 3.0 components, use "
"<literal>@javax.ejb.ApplicationException</literal> instead</emphasis>."
msgstr ""

#. Tag: para
#: Annotations.xml:1010
#, no-c-format
msgid ""
"<literal>rollback</literal> &#8212; by default <literal>false</literal>, if "
"<literal>true</literal> this exception should set the transaction to "
"rollback only"
msgstr ""

#. Tag: para
#: Annotations.xml:1018
#, no-c-format
msgid ""
"<literal>end</literal> &#8212; by default <literal>false</literal>, if "
"<literal>true</literal> this exception should end the current long-running "
"conversation"
msgstr ""

#. Tag: literal
#: Annotations.xml:1030
#, no-c-format
msgid "@Interceptors"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1033
#, no-c-format
msgid "<![CDATA[@Interceptors({DVDInterceptor, CDInterceptor})]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1034
#, no-c-format
msgid ""
"Synonym for javax.interceptors.Interceptors, for use in a pre Java EE 5 "
"environment. Note that this may only be used as a meta-annotation. Declares "
"an ordered list of interceptors for a class or method."
msgstr ""

#. Tag: para
#: Annotations.xml:1040
#, no-c-format
msgid ""
"<emphasis>Do not use this annotations on EJB 3.0 components, use "
"<literal>@javax.interceptor.Interceptors</literal> instead</emphasis>."
msgstr ""

#. Tag: para
#: Annotations.xml:1049
#, no-c-format
msgid ""
"These annotations are mostly useful for JavaBean Seam components. If you use "
"EJB 3.0 components, you should use the standard Java EE5 annotation."
msgstr ""

#. Tag: title
#: Annotations.xml:1057
#, no-c-format
msgid "Annotations for exceptions"
msgstr ""

#. Tag: para
#: Annotations.xml:1059
#, no-c-format
msgid ""
"These annotations let you specify how Seam should handle an exception that "
"propagates out of a Seam component."
msgstr ""

#. Tag: literal
#: Annotations.xml:1067
#, no-c-format
msgid "@Redirect"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1070
#, no-c-format
msgid "<![CDATA[@Redirect(viewId=\"error.jsp\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1071
#, no-c-format
msgid ""
"Specifies that the annotated exception causes a browser redirect to a "
"specified view id."
msgstr ""

#. Tag: para
#: Annotations.xml:1077
#, no-c-format
msgid ""
"<literal>viewId</literal> &#8212; specifies the JSF view id to redirect to. "
"You can use EL here."
msgstr ""

#. Tag: para
#: Annotations.xml:1083
#, no-c-format
msgid ""
"<literal>message</literal> &#8212; a message to be displayed, default to the "
"exception message."
msgstr ""

#. Tag: para
#: Annotations.xml:1089 Annotations.xml:1122
#, no-c-format
msgid ""
"<literal>end</literal> &#8212; specifies that the long-running conversation "
"should end, default to <literal>false</literal>."
msgstr ""

#. Tag: literal
#: Annotations.xml:1100
#, no-c-format
msgid "@HttpError"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1103
#, no-c-format
msgid "<![CDATA[@HttpError(errorCode=404)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1104
#, no-c-format
msgid "Specifies that the annotated exception causes a HTTP error to be sent."
msgstr ""

#. Tag: para
#: Annotations.xml:1110
#, no-c-format
msgid ""
"<literal>errorCode</literal> &#8212; the HTTP error code, default to "
"<literal>500</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:1116
#, no-c-format
msgid ""
"<literal>message</literal> &#8212; a message to be sent with the HTTP error, "
"default to the exception message."
msgstr ""

#. Tag: title
#: Annotations.xml:1135
#, no-c-format
msgid "Annotations for Seam Remoting"
msgstr ""

#. Tag: para
#: Annotations.xml:1136
#, no-c-format
msgid ""
"Seam Remoting requires that the local interface of a session bean be "
"annotated with the following annotation:"
msgstr ""

#. Tag: literal
#: Annotations.xml:1144
#, no-c-format
msgid "@WebRemote"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1147
#, no-c-format
msgid "<![CDATA[@WebRemote(exclude=\"path.to.exclude\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1148
#, no-c-format
msgid ""
"Indicates that the annotated method may be called from client-side "
"JavaScript. The <literal>exclude</literal> property is optional and allows "
"objects to be excluded from the result's object graph (see the Remoting "
"chapter for more details)."
msgstr ""

#. Tag: title
#: Annotations.xml:1162
#, no-c-format
msgid "Annotations for Seam interceptors"
msgstr ""

#. Tag: para
#: Annotations.xml:1163
#, no-c-format
msgid "The following annotations appear on Seam interceptor classes."
msgstr ""

#. Tag: para
#: Annotations.xml:1166
#, no-c-format
msgid ""
"Please refer to the documentation for the EJB 3.0 specification for "
"information about the annotations required for EJB interceptor definition."
msgstr ""

#. Tag: literal
#: Annotations.xml:1174
#, no-c-format
msgid "@Interceptor"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1177
#, no-c-format
msgid "<![CDATA[@Interceptor(stateless=true)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1178
#, no-c-format
msgid ""
"Specifies that this interceptor is stateless and Seam may optimize "
"replication."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1182
#, no-c-format
msgid "<![CDATA[@Interceptor(type=CLIENT)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1183
#, no-c-format
msgid ""
"Specifies that this interceptor is a \"client-side\" interceptor that is "
"called before the EJB container."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1187
#, no-c-format
msgid ""
"<![CDATA[@Interceptor(around={SomeInterceptor.class, OtherInterceptor."
"class})]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1188
#, no-c-format
msgid ""
"Specifies that this interceptor is positioned higher in the stack than the "
"given interceptors."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1192
#, no-c-format
msgid ""
"<![CDATA[@Interceptor(within={SomeInterceptor.class, OtherInterceptor."
"class})]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1193
#, no-c-format
msgid ""
"Specifies that this interceptor is positioned deeper in the stack than the "
"given interceptors."
msgstr ""

#. Tag: title
#: Annotations.xml:1204
#, no-c-format
msgid "Annotations for asynchronicity"
msgstr ""

#. Tag: para
#: Annotations.xml:1205
#, no-c-format
msgid ""
"The following annotations are used to declare an asynchronous method, for "
"example:"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1210
#, no-c-format
msgid ""
"<![CDATA[@Asynchronous public void scheduleAlert(Alert alert, @Expiration "
"Date date) { ... }]]>"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1211
#, no-c-format
msgid ""
"<![CDATA[@Asynchronous public Timer scheduleAlerts(Alert alert, \n"
"   @Expiration Date date, \n"
"   @IntervalDuration long interval) { ... }]]>"
msgstr ""

#. Tag: literal
#: Annotations.xml:1216
#, no-c-format
msgid "@Asynchronous"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1219
#, no-c-format
msgid "<![CDATA[@Asynchronous]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1220
#, no-c-format
msgid "Specifies that the method call is processed asynchronously."
msgstr ""

#. Tag: literal
#: Annotations.xml:1227
#, no-c-format
msgid "@Duration"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1230
#, no-c-format
msgid "<![CDATA[@Duration]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1231
#, no-c-format
msgid ""
"Specifies that a parameter of the asynchronous call is the duration before "
"the call is processed (or first processed for recurring calls)."
msgstr ""

#. Tag: literal
#: Annotations.xml:1240
#, no-c-format
msgid "@Expiration"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1243
#, no-c-format
msgid "<![CDATA[@Expiration]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1244
#, no-c-format
msgid ""
"Specifies that a parameter of the asynchronous call is the datetime at which "
"the call is processed (or first processed for recurring calls)."
msgstr ""

#. Tag: literal
#: Annotations.xml:1253
#, no-c-format
msgid "@IntervalDuration"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1256
#, no-c-format
msgid "<![CDATA[@IntervalDuration]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1257
#, no-c-format
msgid ""
"Specifies that an asynchronous method call recurs, and that the annotationed "
"parameter is duration between recurrences."
msgstr ""

#. Tag: title
#: Annotations.xml:1267
#, no-c-format
msgid "Annotations for use with JSF"
msgstr ""

#. Tag: para
#: Annotations.xml:1268
#, no-c-format
msgid "The following annotations make working with JSF easier."
msgstr ""

#. Tag: literal
#: Annotations.xml:1275
#, no-c-format
msgid "@Converter"
msgstr ""

#. Tag: para
#: Annotations.xml:1278
#, no-c-format
msgid ""
"Allows a Seam component to act as a JSF converter. The annotated class must "
"be a Seam component, and must implement <literal>javax.faces.convert."
"Converter</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:1285
#, no-c-format
msgid ""
"<literal>id</literal> &#8212; the JSF converter id. Defaults to the "
"component name."
msgstr ""

#. Tag: para
#: Annotations.xml:1291
#, no-c-format
msgid ""
"<literal>forClass</literal> &#8212; if specified, register this component as "
"the default converter for a type."
msgstr ""

#. Tag: literal
#: Annotations.xml:1302
#, no-c-format
msgid "@Validator"
msgstr ""

#. Tag: para
#: Annotations.xml:1305
#, no-c-format
msgid ""
"Allows a Seam component to act as a JSF validator. The annotated class must "
"be a Seam component, and must implement <literal>javax.faces.validator."
"Validator</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:1312
#, no-c-format
msgid ""
"<literal>id</literal> &#8212; the JSF validator id. Defaults to the "
"component name."
msgstr ""

#. Tag: title
#: Annotations.xml:1323
#, no-c-format
msgid "Annotations for use with <literal>dataTable</literal>"
msgstr ""

#. Tag: para
#: Annotations.xml:1324
#, no-c-format
msgid ""
"The following annotations make it easy to implement clickable lists backed "
"by a stateful session bean. They appear on attributes."
msgstr ""

#. Tag: literal
#: Annotations.xml:1333
#, no-c-format
msgid "@DataModel"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1336
#, no-c-format
msgid "<![CDATA[@DataModel(\"variableName\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1337
#, no-c-format
msgid ""
"Outjects a property of type <literal>List</literal>, <literal>Map</literal>, "
"<literal>Set</literal> or <literal>Object[]</literal> as a JSF "
"<literal>DataModel</literal> into the scope of the owning component (or the "
"<literal>EVENT</literal> scope if the owning component is "
"<literal>STATELESS</literal>). In the case of <literal>Map</literal>, each "
"row of the <literal>DataModel</literal> is a <literal>Map.Entry</literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:1350
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; name of the conversation context variable. "
"Default to the attribute name."
msgstr ""

#. Tag: para
#: Annotations.xml:1357
#, no-c-format
msgid ""
"<literal>scope</literal> &#8212; if <literal>scope=ScopeType.PAGE</literal> "
"is explicitly specified, the <literal>DataModel</literal> will be kept in "
"the <literal>PAGE</literal> context."
msgstr ""

#. Tag: literal
#: Annotations.xml:1369
#, no-c-format
msgid "@DataModelSelection"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1372
#, no-c-format
msgid "<![CDATA[@DataModelSelection]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1373
#, no-c-format
msgid ""
"Injects the selected value from the JSF <literal>DataModel</literal> (this "
"is the element of the underlying collection, or the map value). If only one "
"<literal>@DataModel</literal> attribute is defined for a component, the "
"selected value from that <literal>DataModel</literal> will be injected. "
"Otherwise, the component name of each <literal>@DataModel</literal> must be "
"specified in the value attribute for each <literal>@DataModelSelection</"
"literal>."
msgstr ""

#. Tag: para
#: Annotations.xml:1385
#, no-c-format
msgid ""
"If <literal>PAGE</literal> scope is specified on the associated "
"<literal>@DataModel</literal>, then, in addition to the DataModel Selection "
"being injected, the associated DataModel will also be injected. In this "
"case, if the property annotated with <literal>@DataModel</literal> is a "
"getter method, then a setter method for the property must also be part of "
"the Business API of the containing Seam Component."
msgstr ""

#. Tag: para
#: Annotations.xml:1397 Annotations.xml:1427
#, no-c-format
msgid ""
"<literal>value</literal> &#8212; name of the conversation context variable. "
"Not needed if there is exactly one <literal>@DataModel</literal> in the "
"component."
msgstr ""

#. Tag: literal
#: Annotations.xml:1409
#, no-c-format
msgid "@DataModelSelectionIndex"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1412
#, no-c-format
msgid "<![CDATA[@DataModelSelectionIndex]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1413
#, no-c-format
msgid ""
"Exposes the selection index of the JSF <literal>DataModel</literal> as an "
"attribute of the component (this is the row number of the underlying "
"collection, or the map key). If only one <literal>@DataModel</literal> "
"attribute is defined for a component, the selected value from that "
"<literal>DataModel</literal> will be injected. Otherwise, the component name "
"of each <literal>@DataModel</literal> must be specified in the value "
"attribute for each <literal>@DataModelSelectionIndex</literal>."
msgstr ""

#. Tag: title
#: Annotations.xml:1442
#, no-c-format
msgid "Meta-annotations for databinding"
msgstr ""

#. Tag: para
#: Annotations.xml:1443
#, no-c-format
msgid ""
"These meta-annotations make it possible to implement similar functionality "
"to <literal>@DataModel</literal> and <literal>@DataModelSelection</literal> "
"for other datastructures apart from lists."
msgstr ""

#. Tag: literal
#: Annotations.xml:1453
#, no-c-format
msgid "@DataBinderClass"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1456
#, no-c-format
msgid "<![CDATA[@DataBinderClass(DataModelBinder.class)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1457
#, no-c-format
msgid "Specifies that an annotation is a databinding annotation."
msgstr ""

#. Tag: literal
#: Annotations.xml:1464
#, no-c-format
msgid "@DataSelectorClass"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1467
#, no-c-format
msgid "<![CDATA[@DataSelectorClass(DataModelSelector.class)]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1468
#, no-c-format
msgid "Specifies that an annotation is a dataselection annotation."
msgstr ""

#. Tag: title
#: Annotations.xml:1477
#, no-c-format
msgid "Annotations for packaging"
msgstr ""

#. Tag: para
#: Annotations.xml:1478
#, no-c-format
msgid ""
"This annotation provides a mechanism for declaring information about a set "
"of components that are packaged together. It can be applied to any Java "
"package."
msgstr ""

#. Tag: literal
#: Annotations.xml:1488
#, no-c-format
msgid "@Namespace"
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1491
#, no-c-format
msgid ""
"<![CDATA[@Namespace(value=\"http://jboss.com/products/seam/example/seampay"
"\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1492
#, no-c-format
msgid ""
"Specifies that components in the current package are associated with the "
"given namespace. The declared namespace can be used as an XML namespace in a "
"<literal>components.xml</literal> file to simplify application configuration."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1498
#, no-c-format
msgid ""
"<![CDATA[@Namespace(value=\"http://jboss.com/products/seam/core\", prefix="
"\"org.jboss.seam.core\")]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1499
#, no-c-format
msgid ""
"Specifies a namespace to associate with a given package. Additionally, it "
"specifies a component name prefix to be applied to component names specified "
"in the XML file. For example, an XML element named <literal>init</literal> "
"that is associated with this namespace would be understood to actually refer "
"to a component named <literal>org.jboss.seam.core.init</literal>."
msgstr ""

#. Tag: title
#: Annotations.xml:1514
#, no-c-format
msgid "Annotations for integrating with the servlet container"
msgstr ""

#. Tag: para
#: Annotations.xml:1515
#, no-c-format
msgid ""
"These annotations allow you to integrate your Seam components with the "
"servlet container."
msgstr ""

#. Tag: literal
#: Annotations.xml:1524
#, no-c-format
msgid "@Filter"
msgstr ""

#. Tag: para
#: Annotations.xml:1527
#, no-c-format
msgid ""
"Use the Seam component (which implements <literal>javax.servlet.Filter</"
"literal>) annotated with <literal>@Filter</literal> as a servlet filter. It "
"will be executed by Seam's master filter."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1535
#, no-c-format
msgid "<![CDATA[@Filter(around={\"seamComponent\", \"otherSeamComponent\"})]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1536
#, no-c-format
msgid ""
"Specifies that this filter is positioned higher in the stack than the given "
"filters."
msgstr ""

#. Tag: programlisting
#: Annotations.xml:1542
#, no-c-format
msgid "<![CDATA[@Filter(within={\"seamComponent\", \"otherSeamComponent\"})]]>"
msgstr ""

#. Tag: para
#: Annotations.xml:1543
#, no-c-format
msgid ""
"Specifies that this filter is positioned deeper in the stack than the given "
"filters."
msgstr ""
