[jboss-cvs] JBossAS SVN: r91414 - projects/docs/enterprise/4.3.3/Server_Configuration_Guide/pt-BR.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Mon Jul 20 02:34:17 EDT 2009
Author: ldelima at redhat.com
Date: 2009-07-20 02:34:17 -0400 (Mon, 20 Jul 2009)
New Revision: 91414
Modified:
projects/docs/enterprise/4.3.3/Server_Configuration_Guide/pt-BR/The_CMP_Engine.po
Log:
translation ongoing
Modified: projects/docs/enterprise/4.3.3/Server_Configuration_Guide/pt-BR/The_CMP_Engine.po
===================================================================
--- projects/docs/enterprise/4.3.3/Server_Configuration_Guide/pt-BR/The_CMP_Engine.po 2009-07-20 06:30:04 UTC (rev 91413)
+++ projects/docs/enterprise/4.3.3/Server_Configuration_Guide/pt-BR/The_CMP_Engine.po 2009-07-20 06:34:17 UTC (rev 91414)
@@ -8,7 +8,7 @@
"Project-Id-Version: The_CMP_Engine\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
"POT-Creation-Date: 2009-01-20 02:37+0000\n"
-"PO-Revision-Date: 2009-07-20 16:29+1000\n"
+"PO-Revision-Date: 2009-07-20 16:34+1000\n"
"Last-Translator: \n"
"Language-Team: <en at li.org>\n"
"MIME-Version: 1.0\n"
@@ -1713,12 +1713,24 @@
" </enterprise-beans>\n"
"</jbosscmp-jdbc>"
msgstr ""
+"<jbosscmp-jdbc>\n"
+" <enterprise-beans>\n"
+" <entity>\n"
+" <ejb-name>GangsterEJB</ejb-name>\n"
+" <cmp-field>\n"
+" <field-name>lastUpdated</field-name>\n"
+" <read-only>true</read-only>\n"
+" <read-time-out>1000</read-time-out>\n"
+" </cmp-field>\n"
+" </entity>\n"
+" </enterprise-beans>\n"
+"</jbosscmp-jdbc>"
#. Tag: title
#: The_CMP_Engine.xml:445
#, no-c-format
msgid "Auditing Entity Access"
-msgstr ""
+msgstr "Auditing Entity Access"
#. Tag: para
#: The_CMP_Engine.xml:446
@@ -1731,68 +1743,74 @@
"linkend=\"Auditing_Entity_Access-The_jbosscmp_jdbc."
"xml_audit_element_content_model\"/>."
msgstr ""
+"The <literal>audit</literal> element of the entity section allows one to "
+"specify how access to and entity bean is audited. This is only allowed when "
+"an entity bean is accessed under a security domain so that this is a caller "
+"identity established. The content model of the audit element is given <xref "
+"linkend=\"Auditing_Entity_Access-The_jbosscmp_jdbc."
+"xml_audit_element_content_model\"/>."
#. Tag: title
#: The_CMP_Engine.xml:450
#, no-c-format
msgid "The jbosscmp-jdbc.xml audit element content model"
-msgstr ""
+msgstr "The jbosscmp-jdbc.xml audit element content model"
#. Tag: para
#: The_CMP_Engine.xml:459
-#, fuzzy, no-c-format
+#, no-c-format
msgid ""
"<emphasis role=\"bold\">created-by</emphasis>: This optional element "
"indicates that the caller who created the entity should be saved to either "
"the indicated <literal>column-name</literal> or cmp <literal>field-name</"
"literal>."
msgstr ""
-"<emphasis role=\"bold\">LenientEjbLink</emphasis>: Esta sinalização indica "
-"que os erros<literal>ejb-link </literal> devem ser ignorados para tentar o "
-"<literal>jndi-name </literal> no <literal>jboss-web.xml</literal>. O padrão "
-"é verdadeiro. "
+"<emphasis role=\"bold\">created-by</emphasis>: This optional element "
+"indicates that the caller who created the entity should be saved to either "
+"the indicated <literal>column-name</literal> or cmp <literal>field-name</"
+"literal>."
#. Tag: para
#: The_CMP_Engine.xml:464
-#, fuzzy, no-c-format
+#, no-c-format
msgid ""
"<emphasis role=\"bold\">created-time</emphasis>: This optional element "
"indicates that the time of entity creation should be saved to either the "
"indicated <literal>column-name</literal> or cmp <literal>field-name</"
"literal>."
msgstr ""
-"<emphasis role=\"bold\">LenientEjbLink</emphasis>: Esta sinalização indica "
-"que os erros<literal>ejb-link </literal> devem ser ignorados para tentar o "
-"<literal>jndi-name </literal> no <literal>jboss-web.xml</literal>. O padrão "
-"é verdadeiro. "
+"<emphasis role=\"bold\">created-time</emphasis>: This optional element "
+"indicates that the time of entity creation should be saved to either the "
+"indicated <literal>column-name</literal> or cmp <literal>field-name</"
+"literal>."
#. Tag: para
#: The_CMP_Engine.xml:469
-#, fuzzy, no-c-format
+#, no-c-format
msgid ""
"<emphasis role=\"bold\">updated-by</emphasis>: This optional element "
"indicates that the caller who last modified the entity should be saved to "
"either the indicated <literal>column-name</literal> or CMP <literal>field-"
"name</literal>."
msgstr ""
-"<emphasis role=\"bold\">LenientEjbLink</emphasis>: Esta sinalização indica "
-"que os erros<literal>ejb-link </literal> devem ser ignorados para tentar o "
-"<literal>jndi-name </literal> no <literal>jboss-web.xml</literal>. O padrão "
-"é verdadeiro. "
+"<emphasis role=\"bold\">updated-by</emphasis>: This optional element "
+"indicates that the caller who last modified the entity should be saved to "
+"either the indicated <literal>column-name</literal> or CMP <literal>field-"
+"name</literal>."
#. Tag: para
#: The_CMP_Engine.xml:474
-#, fuzzy, no-c-format
+#, no-c-format
msgid ""
"<emphasis role=\"bold\">updated-time</emphasis>: This optional element "
"indicates that the last time of entity modification should be saved to "
"either the indicated <literal>column-name</literal> or CMP <literal>field-"
"name</literal>."
msgstr ""
-"<emphasis role=\"bold\">LenientEjbLink</emphasis>: Esta sinalização indica "
-"que os erros<literal>ejb-link </literal> devem ser ignorados para tentar o "
-"<literal>jndi-name </literal> no <literal>jboss-web.xml</literal>. O padrão "
-"é verdadeiro. "
+"<emphasis role=\"bold\">updated-time</emphasis>: This optional element "
+"indicates that the last time of entity modification should be saved to "
+"either the indicated <literal>column-name</literal> or CMP <literal>field-"
+"name</literal>."
#. Tag: para
#: The_CMP_Engine.xml:479
@@ -1808,6 +1826,15 @@
"will be able to access audit information in EJB-QL queries using the audit "
"field names, but not directly through the entity accessors."
msgstr ""
+"For each element, if a <literal>field-name</literal> is given, the "
+"corresponding audit information should be stored in the specified CMP field "
+"of the entity bean being accessed. Note that there does not have to be an "
+"corresponding CMP field declared on the entity. In case there are matching "
+"field names, you will be able to access audit fields in the application "
+"using the corresponding CMP field abstract getters and setters. Otherwise, "
+"the audit fields will be created and added to the entity internally. You "
+"will be able to access audit information in EJB-QL queries using the audit "
+"field names, but not directly through the entity accessors."
#. Tag: para
#: The_CMP_Engine.xml:482
@@ -1819,16 +1846,21 @@
"literal> and <literal>sql-type</literal> element can then be used to define "
"the storage type."
msgstr ""
+"If, on the other hand, a <literal>column-name</literal> is specified, the "
+"corresponding audit information should be stored in the indicated column of "
+"the entity table. If JBoss is creating the table the <literal>jdbc-type</"
+"literal> and <literal>sql-type</literal> element can then be used to define "
+"the storage type."
#. Tag: para
#: The_CMP_Engine.xml:485
#, no-c-format
msgid "The declaration of audit information with given column names is shown below."
-msgstr ""
+msgstr "The declaration of audit information with given column names is shown below."
#. Tag: programlisting
#: The_CMP_Engine.xml:488
-#, fuzzy, no-c-format
+#, no-c-format
msgid ""
"<jbosscmp-jdbc>\n"
" <enterprise-beans>\n"
@@ -1853,33 +1885,34 @@
" </enterprise-beans>\n"
"</jbosscmp-jdbc>"
msgstr ""
-"<jboss> \n"
-" <enterprise-beans> \n"
-" <session> \n"
-" <ejb-name>nextgen.StatelessSession</ejb-"
-"name> \n"
-" <jndi-name>nextgen.StatelessSession</jndi-"
-"name> \n"
-" <clustered>True</clustered> \n"
-" <cluster-config> \n"
-" <partition-name>DefaultPartition</partition-"
-"name> \n"
-" <home-load-balance-policy> \n"
-" org.jboss.ha.framework.interfaces.RoundRobin \n"
-" </home-load-balance-policy> \n"
-" <bean-load-balance-policy> \n"
-" org.jboss.ha.framework.interfaces.RoundRobin\n"
-" </bean-load-balance-policy>\n"
-" </cluster-config>\n"
-" </session>\n"
+"<jbosscmp-jdbc>\n"
+" <enterprise-beans>\n"
+" <entity>\n"
+" <ejb-name>AuditChangedNamesEJB</ejb-name>\n"
+" <table-name>cmp2_audit_changednames</table-name>\n"
+" <audit>\n"
+" <created-by>\n"
+" <column-name>createdby</column-name>\n"
+" </created-by>\n"
+" <created-time>\n"
+" <column-name>createdtime</column-name>\n"
+" </created-time>\n"
+" <updated-by>\n"
+" <column-name>updatedby</column-name></"
+"updated-by>\n"
+" <updated-time>\n"
+" <column-name>updatedtime</column-name>\n"
+" </updated-time>\n"
+" </audit>\n"
+" </entity>\n"
" </enterprise-beans>\n"
-"</jboss>"
+"</jbosscmp-jdbc>"
#. Tag: title
#: The_CMP_Engine.xml:492
#, no-c-format
msgid "Dependent Value Classes (DVCs)"
-msgstr ""
+msgstr "Dependent Value Classes (DVCs)"
#. Tag: para
#: The_CMP_Engine.xml:493
@@ -1892,6 +1925,12 @@
"single database column. Although not discussed here, there are several known "
"issues with the long-term storage of classes in serialized form."
msgstr ""
+"A dependent value class (DVC) is a fancy term used to identity any Java "
+"class that is the type of a <literal>cmp-field</literal> other than the "
+"automatically recognized types core types such as strings and number values. "
+"By default, a DVC is serialized, and the serialized form is stored in a "
+"single database column. Although not discussed here, there are several known "
+"issues with the long-term storage of classes in serialized form."
#. Tag: para
#: The_CMP_Engine.xml:496
@@ -1908,6 +1947,16 @@
"s name spread across several fields. With a DVC, multiple columns can be "
"mapped to one logical field."
msgstr ""
+"JBoss also supports the storage of the internal data of a DVC into one or "
+"more columns. This is useful for supporting legacy JavaBeans and database "
+"structures. It is not uncommon to find a database with a highly flattened "
+"structure (e.g., a <literal>PURCHASE_ORDER</literal> table with the fields "
+"<literal>SHIP_LINE1</literal>, <literal>SHIP_LINE2</literal>, "
+"<literal>SHIP_CITY</literal>, etc. and an additional set of fields for the "
+"billing address). Other common database structures include telephone numbers "
+"with separate fields for area code, exchange, and extension, or a person'"
+"s name spread across several fields. With a DVC, multiple columns can be "
+"mapped to one logical field."
#. Tag: para
#: The_CMP_Engine.xml:499
@@ -1922,18 +1971,26 @@
"literal> element within the <literal>dependent-value-classes</literal> "
"element."
msgstr ""
+"JBoss requires that a DVC to be mapped must follow the JavaBeans naming "
+"specification for simple properties, and that each property to be stored in "
+"the database must have both a getter and a setter method. Furthermore, the "
+"bean must be serializable and must have a no argument constructor. A "
+"property can be any simple type, an unmapped DVC or a mapped DVC, but cannot "
+"be an EJB. A DVC mapping is specified in a <literal>dependent-value-class</"
+"literal> element within the <literal>dependent-value-classes</literal> "
+"element."
#. Tag: title
#: The_CMP_Engine.xml:503
#, no-c-format
msgid "The jbosscmp-jdbc dependent-value-class element model."
-msgstr ""
+msgstr "The jbosscmp-jdbc dependent-value-class element model."
#. Tag: para
#: The_CMP_Engine.xml:510
#, no-c-format
msgid "Here is an example of a simple <literal>ContactInfo</literal> DVC class."
-msgstr ""
+msgstr "Here is an example of a simple <literal>ContactInfo</literal> DVC class."
#. Tag: programlisting
#: The_CMP_Engine.xml:513
@@ -1985,6 +2042,51 @@
" // ... equals, hashCode, toString \n"
"}"
msgstr ""
+"public class ContactInfo \n"
+" implements Serializable \n"
+"{\n"
+" /** The cell phone number. */\n"
+" private PhoneNumber cell;\n"
+" \n"
+" /** The pager number. */\n"
+" private PhoneNumber pager;\n"
+" \n"
+" /** The email address */\n"
+" private String email;\n"
+"\n"
+" \n"
+" /**\n"
+" * Creates empty contact info.\n"
+" */\n"
+" public ContactInfo() {\n"
+" }\n"
+"\n"
+" public PhoneNumber getCell() {\n"
+" return cell;\n"
+" }\n"
+" \n"
+" public void setCell(PhoneNumber cell) {\n"
+" this.cell = cell;\n"
+" }\n"
+" \n"
+" public PhoneNumber getPager() {\n"
+" return pager;\n"
+" }\n"
+" \n"
+" public void setPager(PhoneNumber pager) {\n"
+" this.pager = pager;\n"
+" }\n"
+" \n"
+" public String getEmail() {\n"
+" return email;\n"
+" }\n"
+"\n"
+" public void setEmail(String email) {\n"
+" this.email = email.toLowerCase();\n"
+" }\n"
+" \n"
+" // ... equals, hashCode, toString \n"
+"}"
#. Tag: para
#: The_CMP_Engine.xml:514
@@ -1993,6 +2095,8 @@
"The contact info includes a phone number, which is represented by another "
"DVC class."
msgstr ""
+"The contact info includes a phone number, which is represented by another "
+"DVC class."
#. Tag: programlisting
#: The_CMP_Engine.xml:517
@@ -2015,12 +2119,28 @@
" // ... equals, hashCode, toString\n"
"}"
msgstr ""
+"public class PhoneNumber\n"
+" implements Serializable \n"
+"{\n"
+" /** The first three digits of the phone number. */\n"
+" private short areaCode;\n"
+"\n"
+" /** The middle three digits of the phone number. */\n"
+" private short exchange;\n"
+"\n"
+" /** The last four digits of the phone number. */\n"
+" private short extension;\n"
+"\n"
+" // ... getters and setters \n"
+" \n"
+" // ... equals, hashCode, toString\n"
+"}"
#. Tag: para
#: The_CMP_Engine.xml:518
#, no-c-format
msgid "The DVC mappings for these two classes are relatively straight forward."
-msgstr ""
+msgstr "The DVC mappings for these two classes are relatively straight forward."
#. Tag: programlisting
#: The_CMP_Engine.xml:521
@@ -2064,6 +2184,43 @@
" </dependent-value-class>\n"
"</dependent-value-classes>"
msgstr ""
+"<dependent-value-classes>\n"
+" <dependent-value-class>\n"
+" <description>A phone number</description>\n"
+" <class>org.jboss.cmp2.crimeportal.PhoneNumber</class>\n"
+" <property>\n"
+" <property-name>areaCode</property-name>\n"
+" <column-name>area_code</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>exchange</property-name>\n"
+" <column-name>exchange</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>extension</property-name>\n"
+" <column-name>extension</column-name>\n"
+" </property>\n"
+" </dependent-value-class>\n"
+" \n"
+" <dependent-value-class>\n"
+" <description>General contact info</description>\n"
+" <class>org.jboss.cmp2.crimeportal.ContactInfo</class>\n"
+" <property>\n"
+" <property-name>cell</property-name>\n"
+" <column-name>cell</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>pager</property-name>\n"
+" <column-name>pager</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>email</property-name>\n"
+" <column-name>email</column-name>\n"
+" <jdbc-type>VARCHAR</jdbc-type>\n"
+" <sql-type>VARCHAR(128)</sql-type>\n"
+" </property>\n"
+" </dependent-value-class>\n"
+"</dependent-value-classes>"
#. Tag: para
#: The_CMP_Engine.xml:522
@@ -2078,6 +2235,14 @@
"in the case of a local entity and the entity handle in the case of a remote "
"entity."
msgstr ""
+"Each DVC is declared with a <literal>dependent-value-class</literal> "
+"element. A DVC is identified by the Java class type declared in the class "
+"element. Each property to be persisted is declared with a property element. "
+"This specification is based on the <literal>cmp-field</literal> element, so "
+"it should be self-explanatory. This restriction will also be removed in a "
+"future release. The current proposal involves storing the primary key fields "
+"in the case of a local entity and the entity handle in the case of a remote "
+"entity."
#. Tag: para
#: The_CMP_Engine.xml:525
@@ -2099,6 +2264,21 @@
"named <literal>info</literal> that uses the <literal>ContactInfo</literal> "
"DVC would have the following columns:"
msgstr ""
+"The <literal>dependent-value-classes</literal> section defines the internal "
+"structure and default mapping of the classes. When JBoss encounters a field "
+"that has an unknown type, it searches the list of registered DVCs, and if a "
+"DVC is found, it persists this field into a set of columns, otherwise the "
+"field is stored in serialized form in a single column. JBoss does not "
+"support inheritance of DVCs; therefore, this search is only based on the "
+"declared type of the field. A DVC can be constructed from other DVCs, so "
+"when JBoss runs into a DVC, it flattens the DVC tree structure into a set of "
+"columns. If JBoss finds a DVC circuit during startup, it will throw an "
+"<literal>EJBException</literal>. The default column name of a property is "
+"the column name of the base <literal>cmp-field</literal> followed by an "
+"underscore and then the column name of the property. If the property is a "
+"DVC, the process is repeated. For example, a <literal>cmp-field</literal> "
+"named <literal>info</literal> that uses the <literal>ContactInfo</literal> "
+"DVC would have the following columns:"
#. Tag: programlisting
#: The_CMP_Engine.xml:528
@@ -2112,6 +2292,13 @@
"info_pager_extension\n"
"info_email"
msgstr ""
+"info_cell_area_code\n"
+"info_cell_exchange\n"
+"info_cell_extension\n"
+"info_pager_area_code\n"
+"info_pager_exchange\n"
+"info_pager_extension\n"
+"info_email"
#. Tag: para
#: The_CMP_Engine.xml:529
@@ -2121,6 +2308,9 @@
"and awkward. The default mappings of columns can be overridden in the entity "
"element as follows:"
msgstr ""
+"The automatically generated column names can quickly become excessively long "
+"and awkward. The default mappings of columns can be overridden in the entity "
+"element as follows:"
#. Tag: programlisting
#: The_CMP_Engine.xml:532
@@ -2175,6 +2365,54 @@
" </enterprise-beans>\n"
"</jbosscmp-jdbc>"
msgstr ""
+"<jbosscmp-jdbc>\n"
+" <enterprise-beans>\n"
+" <entity>\n"
+" <ejb-name>GangsterEJB</ejb-name>\n"
+" <cmp-field>\n"
+" <field-name>contactInfo</field-name>\n"
+" <property>\n"
+" <property-name>cell.areaCode</property-"
+"name>\n"
+" <column-name>cell_area</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>cell.exchange</property-"
+"name>\n"
+" <column-name>cell_exch</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>cell.extension</property-"
+"name>\n"
+" <column-name>cell_ext</column-name>\n"
+" </property>\n"
+" \n"
+" <property>\n"
+" <property-name>pager.areaCode</property-"
+"name>\n"
+" <column-name>page_area</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>pager.exchange</property-"
+"name>\n"
+" <column-name>page_exch</column-name>\n"
+" </property>\n"
+" <property>\n"
+" <property-name>pager.extension</property-"
+"name>\n"
+" <column-name>page_ext</column-name>\n"
+" </property>\n"
+" \n"
+" <property>\n"
+" <property-name>email</property-name>\n"
+" <column-name>email</column-name>\n"
+" <jdbc-type>VARCHAR</jdbc-type>\n"
+" <sql-type>VARCHAR(128)</sql-type>\n"
+" </property>\n"
+" </cmp-field>\n"
+" </entity>\n"
+" </enterprise-beans>\n"
+"</jbosscmp-jdbc>"
#. Tag: para
#: The_CMP_Engine.xml:533
@@ -2183,12 +2421,14 @@
"When overriding property info for the entity, you need to refer to the "
"property from a flat perspective as in <literal>cell.areaCode</literal>."
msgstr ""
+"When overriding property info for the entity, you need to refer to the "
+"property from a flat perspective as in <literal>cell.areaCode</literal>."
#. Tag: title
#: The_CMP_Engine.xml:541
#, no-c-format
msgid "Container Managed Relationships"
-msgstr ""
+msgstr "Container Managed Relationships"
#. Tag: para
#: The_CMP_Engine.xml:542
@@ -2208,6 +2448,19 @@
"a relationship cannot be created between two entities in separate "
"applications, even in the same application server."
msgstr ""
+"Container Managed Relationships (CMRs) are a powerful new feature of CMP "
+"2.0. Programmers have been creating relationships between entity objects "
+"since EJB 1.0 was introduced (not to mention since the introduction of "
+"databases), but before CMP 2.0 the programmer had to write a lot of code for "
+"each relationship in order to extract the primary key of the related entity "
+"and store it in a pseudo foreign key field. The simplest relationships were "
+"tedious to code, and complex relationships with referential integrity "
+"required many hours to code. With CMP 2.0 there is no need to code "
+"relationships by hand. The container can manage one-to-one, one-to-many and "
+"many-to-many relationships, with referential integrity. One restriction with "
+"CMRs is that they are only defined between local interfaces. This means that "
+"a relationship cannot be created between two entities in separate "
+"applications, even in the same application server."
#. Tag: para
#: The_CMP_Engine.xml:545
@@ -2218,12 +2471,16 @@
"relationship in the <literal>ejb-jar.xml</literal> file. The following two "
"sections describe these steps."
msgstr ""
+"There are two basic steps to create a container managed relationship: create "
+"the <literal>cmr-field</literal> abstract accessors and declare the "
+"relationship in the <literal>ejb-jar.xml</literal> file. The following two "
+"sections describe these steps."
#. Tag: title
#: The_CMP_Engine.xml:549
#, no-c-format
msgid "CMR-Field Abstract Accessors"
-msgstr ""
+msgstr "CMR-Field Abstract Accessors"
#. Tag: para
#: The_CMP_Engine.xml:550
@@ -2237,6 +2494,13 @@
"between organization and gangster, we declare the relationship from "
"organization to gangster in the <literal>OrganizationBean</literal> class:"
msgstr ""
+"CMR-Field abstract accessors have the same signatures as <literal>cmp-"
+"fields</literal>, except that single-valued relationships must return the "
+"local interface of the related entity, and multi-valued relationships can "
+"only return a <literal>java.util.Collection</literal> (or <literal>java.util."
+"Set</literal>) object. For example, to declare a one-to-many relationship "
+"between organization and gangster, we declare the relationship from "
+"organization to gangster in the <literal>OrganizationBean</literal> class:"
#. Tag: programlisting
#: The_CMP_Engine.xml:553
@@ -2249,6 +2513,12 @@
" public abstract void setMemberGangsters(Set gangsters);\n"
"}"
msgstr ""
+"public abstract class OrganizationBean\n"
+" implements EntityBean \n"
+"{\n"
+" public abstract Set getMemberGangsters();\n"
+" public abstract void setMemberGangsters(Set gangsters);\n"
+"}"
#. Tag: para
#: The_CMP_Engine.xml:554
More information about the jboss-cvs-commits
mailing list