alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

Hibernate example source code file (collection_mapping.po)

This example Hibernate source code file (collection_mapping.po) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Hibernate tags/keywords

a, a, child, entity\n, hibernate, hibernate, parent, set, string, tag, tag, the, the, this

The Hibernate collection_mapping.po source code

# translation of collection_mapping.po to
# translation of Collection_Mapping.po to
# translation of Collection_Mapping.po to
# translation of Collection_Mapping.po to
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2006.
# , 2007.
# , 2007.
# , 2007.
# , 2007.
# , 2007.
# , 2007.
# , 2007.
# , 2007.
# , 2007.
# Michael H. Smith <mhideo@redhat.com>, 2007.
# Glaucia Cintra <gcintra@redhat.com>, 2007.
msgid ""
msgstr ""
"Project-Id-Version: collection_mapping\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
"POT-Creation-Date: 2010-07-20 21:02+0000\n"
"PO-Revision-Date: 2010-03-15 16:00+1000\n"
"Last-Translator: \n"
"Language-Team:  <en@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: KBabel 1.11.4\n"

#. Tag: title
#: collection_mapping.xml:31
#, no-c-format
msgid "Collection mapping"
msgstr "Mapeamento de coleção "

#. Tag: title
#: collection_mapping.xml:34
#, no-c-format
msgid "Persistent collections"
msgstr "Coleções persistentes"

#. Tag: para
#: collection_mapping.xml:36
#, fuzzy, no-c-format
msgid ""
"Naturally Hibernate also allows to persist collections. These persistent "
"collections can contain almost any other Hibernate type, including: basic "
"types, custom types, components and references to other entities. The "
"distinction between value and reference semantics is in this context very "
"important. An object in a collection might be handled with \"value\" "
"semantics (its life cycle fully depends on the collection owner), or it "
"might be a reference to another entity with its own life cycle. In the "
"latter case, only the \"link\" between the two objects is considered to be a "
"state held by the collection."
msgstr ""
"As coleções podem conter quase qualquer outro tipo de Hibernate, incluindo "
"todos os tipos básicos, tipos padronizados, e é claro, referências a outras "
"entidades. Isto é uma distinção importante: um objeto em uma coleção pode "
"ser manipulada com as semânticas \"valor\" (seu ciclo de vida depende "
"totalmente do proprietário da coleção), ou ele pode ser uma referência à "
"outra entidade, com seu próprio ciclo de vida. No último caso, somente o "
"\"link\" entre os dois objetos é considerado como estado seguro pela "
"coleção. "

#. Tag: para
#: collection_mapping.xml:46
#, fuzzy, no-c-format
msgid ""
"As a requirement persistent collection-valued fields must be declared as an "
"interface type (see <xref linkend=\"example.collection.mapping.annotations\"/"
">). The actual interface might be <literal>java.util.Set, "
"<literal>java.util.Collection, java.util.List, "
"<literal>java.util.Map, java.util.SortedSet, "
"<literal>java.util.SortedMap or anything you like (\"anything you "
"like\" means you will have to write an implementation of <literal>org."
"hibernate.usertype.UserCollectionType</literal>)."
msgstr ""
"A interface atual pode ser <literal>java.util.Set, java."
"util.Collection</literal>, java.util.List, java."
"util.Map</literal>, java.util.SortedSet, java."
"util.SortedMap</literal> ou o que desejar. (\"o que desejar\" significa que "
"você terá que escrever uma implementação de <literal>org.hibernate.usertype."
"UserCollectionType</literal>.)"

#. Tag: para
#: collection_mapping.xml:57
#, fuzzy, no-c-format
msgid ""
"Notice how in <xref linkend=\"example.collection.mapping.annotations\"/> the "
"instance variable <literal>parts was initialized with an instance "
"of <literal>HashSet. This is the best way to initialize collection "
"valued properties of newly instantiated (non-persistent) instances. When you "
"make the instance persistent, by calling <literal>persist(), "
"Hibernate will actually replace the <literal>HashSet with an "
"instance of Hibernate's own implementation of <literal>Set. Be "
"aware of the following error:"
msgstr ""
"Observe como inicializamos a variável da instância com uma instância de "
"<literal>HashSet. Esta é a melhor maneira de inicializar "
"propriedades de coleções de valor de instâncias recentemente instanciadas "
"(não persistentes). Quando você fizer uma instância persistente, chamando "
"<literal>persist(), como por exemplo: o Hibernate substituirá o "
"<literal>HashSet por uma instância da própria implementação do "
"Hibernate do <literal>Set. Cuidado com erros como este:"

#. Tag: title
#: collection_mapping.xml:68
#, no-c-format
msgid "Hibernate uses its own collection implementations"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:70
#, no-c-format
msgid ""
"Cat cat = new DomesticCat();\n"
"Cat kitten = new DomesticCat();\n"
"....\n"
"Set kittens = new HashSet();\n"
"kittens.add(kitten);\n"
"cat.setKittens(kittens);\n"
"session.persist(cat);\n"
"\n"
"kittens = cat.getKittens(); // Okay, kittens collection is a Set\n"
"(HashSet) cat.getKittens(); // Error!"
msgstr ""

#. Tag: para
#: collection_mapping.xml:73
#, no-c-format
msgid ""
"The persistent collections injected by Hibernate behave like "
"<literal>HashMap, HashSet, TreeMapTreeSet or ArrayList, "
"depending on the interface type."
msgstr ""
"As coleções persistentes injetadas pelo Hibernate, se comportam como "
"<literal>HashMap, HashSet, TreeMapTreeSet ou ArrayList, "
"dependendo do tipo de interface."

#. Tag: para
#: collection_mapping.xml:78
#, no-c-format
msgid ""
"Collections instances have the usual behavior of value types. They are "
"automatically persisted when referenced by a persistent object and are "
"automatically deleted when unreferenced. If a collection is passed from one "
"persistent object to another, its elements might be moved from one table to "
"another. Two entities cannot share a reference to the same collection "
"instance. Due to the underlying relational model, collection-valued "
"properties do not support null value semantics. Hibernate does not "
"distinguish between a null collection reference and an empty collection."
msgstr ""
"As instâncias de coleção têm o comportamento comum de tipos de valores. Eles "
"são automaticamente persistidos quando referenciados por um objeto "
"persistente e automaticamente deletados quando não referenciados. Se a "
"coleção é passada de um objeto persistente para outro, seus elementos devem "
"ser movidos de uma tabela para outra. Duas entidades não devem compartilhar "
"uma referência com uma mesma instância de coleção. Devido ao modelo "
"relacional adjacente, as propriedades de coleções válidas, não suportam "
"semânticas de valores nulos. O Hibernate não distingue entre a referência da "
"coleção nula e uma coleção vazia. "

#. Tag: para
#: collection_mapping.xml:89
#, fuzzy, no-c-format
msgid ""
"Use persistent collections the same way you use ordinary Java collections. "
"However, ensure you understand the semantics of bidirectional associations "
"(see <xref linkend=\"collections-bidirectional\"/>)."
msgstr ""
"Use as coleções persistentes da mesma forma que usa coleções Java comuns. No "
"entanto, somente tenha a certeza de entender as semânticas de associações "
"bidirecionais (as quais serão discutidas mais tarde)."

#. Tag: title
#: collection_mapping.xml:97
#, fuzzy, no-c-format
msgid "How to map collections"
msgstr "Coleções escolhidas"

#. Tag: para
#: collection_mapping.xml:99
#, no-c-format
msgid ""
"Using annotations you can map <classname>Collections, "
"<classname>Lists, Maps and "
"<classname>Sets of associated entities using @OneToMany and "
"@ManyToMany. For collections of a basic or embeddable type use "
"@ElementCollection. In the simplest case a collection mapping looks like "
"this:"
msgstr ""

#. Tag: title
#: collection_mapping.xml:107
#, no-c-format
msgid "Collection mapping using @OneToMany and @JoinColumn"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:109
#, no-c-format
msgid ""
"@Entity\n"
"public class Product {\n"
"\n"
"    private String serialNumber;\n"
"    private Set<Part> parts = new HashSet<Part>();\n"
"\n"
"    @Id\n"
"    public String getSerialNumber() { return serialNumber; }\n"
"    void setSerialNumber(String sn) { serialNumber = sn; }\n"
"   \n"
"    @OneToMany\n"
"    @JoinColumn(name=\"PART_ID\")\n"
"    public Set<Part> getParts() { return parts; }\n"
"    void setParts(Set parts) { this.parts = parts; }\n"
"}\n"
"\n"
"\n"
"@Entity\n"
"public class Part {\n"
"   ...\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:112
#, no-c-format
msgid ""
"Product describes a unidirectional relationship with Part using the join "
"column PART_ID. In this unidirectional one to many scenario you can also use "
"a join table as seen in <xref linkend=\"example-one-to-many-with-join-table"
"\"/>."
msgstr ""

#. Tag: title
#: collection_mapping.xml:118
#, no-c-format
msgid "Collection mapping using @OneToMany and @JoinTable"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:121
#, no-c-format
msgid ""
"@Entity\n"
"public class Product {\n"
"\n"
"    private String serialNumber;\n"
"    private Set<Part> parts = new HashSet<Part>();\n"
"\n"
"    @Id\n"
"    public String getSerialNumber() { return serialNumber; }\n"
"    void setSerialNumber(String sn) { serialNumber = sn; }\n"
"   \n"
"    @OneToMany\n"
"    @JoinTable(\n"
"            name=\"PRODUCT_PARTS\",\n"
"            joinColumns = @JoinColumn( name=\"PRODUCT_ID\"),\n"
"            inverseJoinColumns = @JoinColumn( name=\"PART_ID\")\n"
"    )\n"
"    public Set<Part> getParts() { return parts; }\n"
"    void setParts(Set parts) { this.parts = parts; }\n"
"}\n"
"\n"
"\n"
"@Entity\n"
"public class Part {\n"
"   ...\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:124
#, no-c-format
msgid ""
"Without describing any physical mapping (no <classname>@JoinColumn@JoinTable), a unidirectional one to "
"many with join table is used. The table name is the concatenation of the "
"owner table name, _, and the other side table name. The foreign key name(s) "
"referencing the owner table is the concatenation of the owner table, _, and "
"the owner primary key column(s) name. The foreign key name(s) referencing "
"the other side is the concatenation of the owner property name, _, and the "
"other side primary key column(s) name. A unique constraint is added to the "
"foreign key referencing the other side table to reflect the one to many."
msgstr ""

#. Tag: para
#: collection_mapping.xml:135
#, fuzzy, no-c-format
msgid ""
"Lets have a look now how collections are mapped using Hibernate mapping "
"files. In this case the first step is to chose the right mapping element. It "
"depends on the type of interface. For example, a <literal><set>SetSet. "

#. Tag: title
#: collection_mapping.xml:142
#, no-c-format
msgid "Mapping a Set using <set>"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:144
#, no-c-format
msgid ""
"<class name=\"Product\">\n"
"    <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n"
"    <set name=\"parts\">\n"
"        <key column=\"productSerialNumber\" not-null=\"true\"/>\n"
"        <one-to-many class=\"Part\"/>\n"
"    </set>\n"
"</class>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:147
#, fuzzy, no-c-format
msgid ""
"In <xref linkend=\"example.collections.set\"/> a one-to-many "
"association</emphasis> links the Product and "
"<literal>Part entities. This association requires the existence of "
"a foreign key column and possibly an index column to the <literal>Part até a Parte Uma tag "
"<literal><one-to-many> indica que esta é uma associação um "
"para muitos."

#. Tag: para
#: collection_mapping.xml:156
#, no-c-format
msgid ""
"An instance of the contained entity class cannot belong to more than one "
"instance of the collection."
msgstr ""
"Uma instância de classes entidades contidas, podem não pertencer à mais de "
"uma instância da coleção. "

#. Tag: para
#: collection_mapping.xml:161
#, no-c-format
msgid ""
"An instance of the contained entity class cannot appear at more than one "
"value of the collection index."
msgstr ""
"Uma instância da classe de entidade contida pode não aparecer em mais de um "
"valor do índice da coleção. "

#. Tag: para
#: collection_mapping.xml:166
#, no-c-format
msgid ""
"Looking closer at the used <literal><one-to-many> tag we see "
"that it has the following options."
msgstr ""

#. Tag: title
#: collection_mapping.xml:170
#, no-c-format
msgid "options of <one-to-many> element"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:181
#, no-c-format
msgid ""
"<one-to-many\n"
"        class=\"ClassName\"\n"
"        not-found=\"ignore|exception\"\n"
"        entity-name=\"EntityName\"\n"
"        node=\"element-name\"\n"
"        embed-xml=\"true|false\"\n"
"    />"
msgstr ""

#. Tag: para
#: collection_mapping.xml:185
#, no-c-format
msgid "<literal>class (required): the name of the associated class."
msgstr "<literal>class (requerido): O nome da classe associada. "

#. Tag: para
#: collection_mapping.xml:190
#, no-c-format
msgid ""
"<literal>not-found (optional - defaults to exception will treat a missing row as a null "
"association."
msgstr ""
"<literal>not-found (opcional - padrão para exception tratará a linha "
"faltante como uma associação nula. "

#. Tag: para
#: collection_mapping.xml:198
#, no-c-format
msgid ""
"<literal>entity-name (optional): the entity name of the associated "
"class, as an alternative to <literal>class."
msgstr ""
"<literal>entity-name (opcional): O nome da entidade da classe "
"associada, como uma alternativa para a <literal>class. "

#. Tag: para
#: collection_mapping.xml:206
#, no-c-format
msgid ""
"The <literal><one-to-many> element does not need to declare "
"any columns. Nor is it necessary to specify the <literal>table "
"name anywhere."
msgstr ""
"Note que o elemento <literal><one-to-many> não precisa "
"declarar qualquer coluna. Nem é necessário especificar o nome da "
"<literal>table em qualquer lugar. "

#. Tag: para
#: collection_mapping.xml:211
#, fuzzy, no-c-format
msgid ""
"If the foreign key column of a <literal><one-to-many> "
"association is declared <literal>NOT NULL, you must declare the "
"<literal><key> mapping not-null=\"true\" "
"or <emphasis>use a bidirectional association with the collection "
"mapping marked <literal>inverse=\"true\". See NOT NULL, você deve "
"declarar a <literal><key> mapeando not-null=\"true"
"\"</literal> ou use uma associação bidirecional com o "
"mapeamento da coleção marcado como <literal>inverse=\"true\". Veja "
"a discussão das associações bidirecionais mais tarde neste mesmo capítulo."

#. Tag: para
#: collection_mapping.xml:221
#, fuzzy, no-c-format
msgid ""
"Apart from the <literal><set> tag as shown in <list><map>, <bag>, "
"<literal><array> and <primitive-array><map> element is "
"representative:"
msgstr ""
"Além do <literal><set>, existe também os elementos de "
"mapeamento <literal><list>, <map>, "
"<literal><bag>, <array> and "
"<literal><primitive-array>. O elemento <map>: the collection property name"
msgstr "<literal>name: o nome da propriedade da coleção"

#. Tag: para
#: collection_mapping.xml:270
#, no-c-format
msgid ""
"<literal>table (optional - defaults to property name): the name of "
"the collection table. It is not used for one-to-many associations."
msgstr ""
"<literal>table (opcional - padrão para nome de propriedade): o "
"nome da tabela de coleção. Isto não é usado para associações um-para-muitos."

#. Tag: para
#: collection_mapping.xml:276
#, no-c-format
msgid ""
"<literal>schema (optional): the name of a table schema to override "
"the schema declared on the root element"
msgstr ""
"<literal>schema (opcional): o nome de um esquema de tabela para "
"sobrescrever o esquema declarado no elemento raíz."

#. Tag: para
#: collection_mapping.xml:281
#, no-c-format
msgid ""
"<literal>lazy (optional - defaults to true): "
"disables lazy fetching and specifies that the association is always eagerly "
"fetched. It can also be used to enable \"extra-lazy\" fetching where most "
"operations do not initialize the collection. This is suitable for large "
"collections."
msgstr ""
"<literal>lazy (opcional - padrão para true): "
"pode ser utilizado para desabilitar a busca lazy e especificar que a "
"associação é sempre buscada antecipadamente, ou para habilitar busca \"extra-"
"lazy\" onde a maioria das operações não inicializa a coleção (apropriado "
"para coleções bem grandes)."

#. Tag: para
#: collection_mapping.xml:290
#, no-c-format
msgid ""
"<literal>inverse (optional - defaults to false (opcional - padrão para false (optional - defaults to none): "
"enables operations to cascade to child entities."
msgstr ""
"<literal>cascade (opcional - padrão para none): "
"habilita operações para cascata para entidades filho."

#. Tag: para
#: collection_mapping.xml:302
#, no-c-format
msgid ""
"<literal>sort (optional): specifies a sorted collection with "
"<literal>natural sort order or a given comparator class."
msgstr ""
"<literal>sort (opcional): especifica uma coleção escolhida com "
"ordem de escolha<literal>natural ou uma dada classe comparatória."

#. Tag: para
#: collection_mapping.xml:308
#, fuzzy, no-c-format
msgid ""
"<literal>order-by (optional): specifies a table column or columns "
"that define the iteration order of the <literal>Map, Setasc or "
"<literal>desc."
msgstr ""
"<literal>order-by (opcional, somente JDK1.4): especifica uma "
"coluna da tabela (ou colunas) que define a ordem de iteração do "
"<literal>Map, Set ou bag, juntos com um "
"<literal>asc ou desc opcional."

#. Tag: para
#: collection_mapping.xml:316
#, no-c-format
msgid ""
"<literal>where (optional): specifies an arbitrary SQL "
"<literal>WHERE condition that is used when retrieving or removing "
"the collection. This is useful if the collection needs to contain only a "
"subset of the available data."
msgstr ""
"<literal>where (opcional): especifica uma condição SQL arbitrária "
"<literal>WHERE a ser usada quando recuperar ou remover a coleção "
"Isto é útil se a coleção tiver somente um subconjunto dos dados disponíveis."

#. Tag: para
#: collection_mapping.xml:324
#, no-c-format
msgid ""
"<literal>fetch (optional, defaults to select): "
"chooses between outer-join fetching, fetching by sequential select, and "
"fetching by sequential subselect."
msgstr ""
"<literal>fetch (opcional, padrão para select): "
"escolha entre busca de união externa, busca por seleção sequencial e busca "
"por subseleção sequencial."

#. Tag: para
#: collection_mapping.xml:331
#, no-c-format
msgid ""
"<literal>batch-size (optional, defaults to 1): "
"specifies a \"batch size\" for lazily fetching instances of this collection."
msgstr ""
"<literal>batch-size (opcional, padrão para 1): "
"especifica um \"tamanho de lote\" para instâncias de busca lazy desta "
"coleção."

#. Tag: para
#: collection_mapping.xml:337
#, no-c-format
msgid ""
"<literal>access (optional - defaults to property (opcional - padrão para property (optional - defaults to true (opcional - padrão para true (optional - defaults to true): "
"a value of <literal>false specifies that the elements of the "
"collection never change. This allows for minor performance optimization in "
"some cases."
msgstr ""
"<literal>mutable (opcional - padrão para true): "
"um valor de <literal>false especifica que os elementos  da coleção "
"nunca mudam. Isto permite uma otimização mínima do desempenho em alguns "
"casos."

#. Tag: para
#: collection_mapping.xml:360
#, no-c-format
msgid ""
"After exploring the basic mapping of collections in the preceding paragraphs "
"we will now focus details like physical mapping considerations, indexed "
"collections and collections of value types."
msgstr ""

#. Tag: title
#: collection_mapping.xml:365
#, no-c-format
msgid "Collection foreign keys"
msgstr "Chaves Externas de Coleção"

#. Tag: para
#: collection_mapping.xml:367
#, fuzzy, no-c-format
msgid ""
"On the database level collection instances are distinguished by the foreign "
"key of the entity that owns the collection. This foreign key is referred to "
"as the <emphasis>collection key column, or columns, of the "
"collection table. The collection key column is mapped by the "
"<literal>@JoinColumn annotation respectively the <"
"key></literal> XML element."
msgstr ""
"Instâncias de coleção são distinguidas no banco de dados pela chave exterior "
"da entidade que possui a coleção. Esta chave exterior é referida como a "
"<emphasis>coluna de chave de coleção (ou colunas) da tabela de "
"coleção. A coluna de chave de coleção é mapeada pelo elemento <literal><"
"key></literal>."

#. Tag: para
#: collection_mapping.xml:374
#, fuzzy, no-c-format
msgid ""
"There can be a nullability constraint on the foreign key column. For most "
"collections, this is implied. For unidirectional one-to-many associations, "
"the foreign key column is nullable by default, so you may need to specify"
msgstr ""
"Pode existir uma restrição de nulabilidade na coluna da chave exterior. Para "
"a maioria das coleções, isto está implícito. Para associações unidirecionais "
"um-para-muitos, a coluna de chave estrangeira é anulável por padrão, "
"portanto você pode precisar especificar <literal>not-null=\"true\"."

#. Tag: programlisting
#: collection_mapping.xml:379
#, no-c-format
msgid "@JoinColumn(nullable=false)"
msgstr ""

#. Tag: para
#: collection_mapping.xml:381
#, no-c-format
msgid "<para>or"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:383
#, no-c-format
msgid "<key column=\"productSerialNumber\" not-null=\"true\"/>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:385
#, fuzzy, no-c-format
msgid ""
"The foreign key constraint can use <literal>ON DELETE CASCADE. In "
"XML this can be expressed via:"
msgstr ""
"A restrição da chave exterior pode usar <literal>ON DELETE CASCADE."

#. Tag: programlisting
#: collection_mapping.xml:388
#, no-c-format
msgid "<key column=\"productSerialNumber\" on-delete=\"cascade\"/>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:390
#, no-c-format
msgid ""
"In annotations the Hibernate specific annotation @OnDelete has to be used."
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:393
#, no-c-format
msgid "@OnDelete(action=OnDeleteAction.CASCADE)"
msgstr ""

#. Tag: para
#: collection_mapping.xml:395
#, fuzzy, no-c-format
msgid ""
"See <xref lang=\"\" linkend=\"section.key\"/> for more information about the "
"<literal><key> element."
msgstr ""
"Veja nos capítulos anteriores para uma completa definição do "
"elemento<literal><key>."

#. Tag: title
#: collection_mapping.xml:400
#, no-c-format
msgid "Indexed collections"
msgstr "Coleções indexadas"

#. Tag: para
#: collection_mapping.xml:402
#, no-c-format
msgid ""
"In the following paragraphs we have a closer at the indexed collections "
"<classname>List and Map how the their "
"index can be mapped in Hibernate."
msgstr ""

#. Tag: title
#: collection_mapping.xml:407
#, no-c-format
msgid "Lists"
msgstr ""

#. Tag: para
#: collection_mapping.xml:409
#, no-c-format
msgid "Lists can be mapped in two different ways:"
msgstr ""

#. Tag: para
#: collection_mapping.xml:413
#, no-c-format
msgid "as ordered lists, where the order is not materialized in the database"
msgstr ""

#. Tag: para
#: collection_mapping.xml:418
#, no-c-format
msgid "as indexed lists, where the order is materialized in the database"
msgstr ""

#. Tag: para
#: collection_mapping.xml:423
#, no-c-format
msgid ""
"To order lists in memory, add <literal>@javax.persistence.OrderBy "
"to your property. This annotation takes as parameter a list of comma "
"separated properties (of the target entity) and orders the collection "
"accordingly (eg <code>firstname asc, age desc), if the string is "
"empty, the collection will be ordered by the primary key of the target "
"entity."
msgstr ""

#. Tag: title
#: collection_mapping.xml:432
#, no-c-format
msgid "Ordered lists using <classname>@OrderBy"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:434
#, no-c-format
msgid ""
"@Entity\n"
"public class Customer {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   @OneToMany(mappedBy=\"customer\")\n"
"   @OrderBy(\"number\")\n"
"   public List<Order> getOrders() { return orders; }\n"
"   public void setOrders(List<Order> orders) { this.orders = "
"orders; }\n"
"   private List<Order> orders;\n"
"}\n"
"\n"
"@Entity\n"
"public class Order {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   public String getNumber() { return number; }\n"
"   public void setNumber(String number) { this.number = number; }\n"
"   private String number;\n"
"\n"
"   @ManyToOne\n"
"   public Customer getCustomer() { return customer; }\n"
"   public void setCustomer(Customer customer) { this.customer = customer; }\n"
"   private Customer number;\n"
"}\n"
"\n"
"-- Table schema\n"
"|-------------| |----------|\n"
"| Order       | | Customer |\n"
"|-------------| |----------|\n"
"| id          | | id       |\n"
"| number      | |----------| \n"
"| customer_id |\n"
"|-------------|"
msgstr ""

#. Tag: para
#: collection_mapping.xml:437
#, no-c-format
msgid ""
"To store the index value in a dedicated column, use the <classname>@javax."
"persistence.OrderColumn</classname> annotation on your property. This "
"annotations describes the column name and attributes of the column keeping "
"the index value. This column is hosted on the table containing the "
"association foreign key. If the column name is not specified, the default is "
"the name of the referencing property, followed by underscore, followed by "
"<literal>ORDER (in the following example, it would be "
"<literal>orders_ORDER)."
msgstr ""

#. Tag: title
#: collection_mapping.xml:448
#, no-c-format
msgid "Explicit index column using <classname>@OrderColumn"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:451
#, no-c-format
msgid ""
"@Entity\n"
"public class Customer {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   @OneToMany(mappedBy=\"customer\")\n"
"   @OrderColumn(name=\"orders_index\")\n"
"   public List<Order> getOrders() { return orders; }\n"
"   public void setOrders(List<Order> orders) { this.orders = "
"orders; }\n"
"   private List<Order> orders;\n"
"}\n"
"\n"
"@Entity\n"
"public class Order {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   public String getNumber() { return number; }\n"
"   public void setNumber(String number) { this.number = number; }\n"
"   private String number;\n"
"\n"
"   @ManyToOne\n"
"   public Customer getCustomer() { return customer; }\n"
"   public void setCustomer(Customer customer) { this.customer = customer; }\n"
"   private Customer number;\n"
"}\n"
"\n"
"-- Table schema\n"
"|--------------| |----------|\n"
"| Order        | | Customer |\n"
"|--------------| |----------|\n"
"| id           | | id       |\n"
"| number       | |----------| \n"
"| customer_id  |\n"
"| orders_order |\n"
"|--------------|"
msgstr ""

#. Tag: para
#: collection_mapping.xml:455
#, no-c-format
msgid ""
"We recommend you to convert <classname>the legacy @org.hibernate.annotations."
"IndexColumn</classname> usages to @OrderColumn unless "
"you are making use of the base property. The <literal>base "
"property lets you define the index value of the first element (aka as base "
"index). The usual value is <literal>0 or 1. The "
"default is 0 like in Java."
msgstr ""

#. Tag: para
#: collection_mapping.xml:464
#, no-c-format
msgid ""
"Looking again at the Hibernate mapping file equivalent, the index of an "
"array or list is always of type <literal>integer and is mapped "
"using the <literal><list-index> element. The mapped column "
"contains sequential integers that are numbered from zero by default."
msgstr ""

#. Tag: title
#: collection_mapping.xml:471
#, no-c-format
msgid "index-list element for indexed collections in xml mapping"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:481
#, no-c-format
msgid ""
"<list-index\n"
"        column=\"column_name\"\n"
"        base=\"0|1|...\"/>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:485
#, no-c-format
msgid ""
"<literal>column_name (required): the name of the column holding "
"the collection index values."
msgstr ""
"<literal>column_name (requerido): O nome da coluna que mantém os "
"valores do índice da coleção."

#. Tag: para
#: collection_mapping.xml:490
#, no-c-format
msgid ""
"<literal>base (optional - defaults to 0): the "
"value of the index column that corresponds to the first element of the list "
"or array."
msgstr ""
"<literal>base (opcional - padrão para 0): o "
"valor da coluna de índice que corresponde ao primeiro elemento da lista ou "
"matriz."

#. Tag: para
#: collection_mapping.xml:498
#, no-c-format
msgid ""
"If your table does not have an index column, and you still wish to use "
"<literal>List as the property type, you can map the property as a "
"Hibernate <emphasis><bag>. A bag does not retain its order "
"when it is retrieved from the database, but it can be optionally sorted or "
"ordered."
msgstr ""
"Se sua tabela não possui uma coluna de índice e você ainda quiser usar a "
"<literal>Lista como tipo de propriedade, você deve mapeiar a "
"propriedade como uma <emphasis><bag> do Hibernate. Uma bag "
"não mantém sua ordem quando é recuperadada do banco de dados, mas pode ser "
"escolhida de forma opcional ou ordenada. "

#. Tag: title
#: collection_mapping.xml:506
#, no-c-format
msgid "Maps"
msgstr ""

#. Tag: para
#: collection_mapping.xml:508
#, no-c-format
msgid ""
"The question with <classname>Maps is where the key value is "
"stored. There are everal options. Maps can borrow their keys from one of the "
"associated entity properties or have dedicated columns to store an explicit "
"key."
msgstr ""

#. Tag: para
#: collection_mapping.xml:513
#, no-c-format
msgid ""
"To use one of the target entity property as a key of the map, use "
"<literal>@MapKey(name=\"myProperty\"), where myProperty without the name attribuate, the target entity "
"primary key is used. The map key uses the same column as the property "
"pointed out. There is no additional column defined to hold the map key, "
"because the map key represent a target property. Be aware that once loaded, "
"the key is no longer kept in sync with the property. In other words, if you "
"change the property value, the key will not change automatically in your "
"Java model."
msgstr ""

#. Tag: title
#: collection_mapping.xml:525
#, no-c-format
msgid ""
"Use of target entity property as map key via <classname>@MapKey"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:528
#, no-c-format
msgid ""
"@Entity\n"
"public class Customer {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   @OneToMany(mappedBy=\"customer\")\n"
"   @MapKey(name=\"number\")\n"
"   public Map<String,Order> getOrders() { return orders; }\n"
"   public void setOrders(Map<String,Order> order) { this.orders = "
"orders; }\n"
"   private Map<String,Order> orders;\n"
"}\n"
"\n"
"@Entity\n"
"public class Order {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   public String getNumber() { return number; }\n"
"   public void setNumber(String number) { this.number = number; }\n"
"   private String number;\n"
"\n"
"   @ManyToOne\n"
"   public Customer getCustomer() { return customer; }\n"
"   public void setCustomer(Customer customer) { this.customer = customer; }\n"
"   private Customer number;\n"
"}\n"
"\n"
"-- Table schema\n"
"|-------------| |----------|\n"
"| Order       | | Customer |\n"
"|-------------| |----------|\n"
"| id          | | id       |\n"
"| number      | |----------| \n"
"| customer_id |\n"
"|-------------|"
msgstr ""

#. Tag: para
#: collection_mapping.xml:531
#, no-c-format
msgid ""
"Alternatively the map key is mapped to a dedicated column or columns. In "
"order to customize the mapping use one of the following annotations:"
msgstr ""

#. Tag: para
#: collection_mapping.xml:537
#, no-c-format
msgid ""
"@<classname>MapKeyColumn if the map key is a basic type. If you "
"don't specify the column name, the name of the property followed by "
"underscore followed by <literal>KEY is used (for example "
"<literal>orders_KEY)."
msgstr ""

#. Tag: para
#: collection_mapping.xml:544
#, no-c-format
msgid ""
"<classname>@MapKeyEnumerated / @MapKeyTemporalDate/@MapKeyJoinColumns/@AttributeOverrideskey. to define the type of "
"the key if you don't use generics."
msgstr ""

#. Tag: title
#: collection_mapping.xml:566
#, no-c-format
msgid "Map key as basic type using <classname>@MapKeyColumn"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:569
#, no-c-format
msgid ""
"@Entity\n"
"public class Customer {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   @OneToMany @JoinTable(name=\"Cust_Order\")\n"
"   @MapKeyColumn(name=\"orders_number\")\n"
"   public Map<String,Order> getOrders() { return orders; }\n"
"   public void setOrders(Map<String,Order> orders) { this.orders = "
"orders; }\n"
"   private Map<String,Order> orders;\n"
"}\n"
"\n"
"@Entity\n"
"public class Order {\n"
"   @Id @GeneratedValue public Integer getId() { return id; }\n"
"   public void setId(Integer id) { this.id = id; }\n"
"   private Integer id;\n"
"\n"
"   public String getNumber() { return number; }\n"
"   public void setNumber(String number) { this.number = number; }\n"
"   private String number;\n"
"\n"
"   @ManyToOne\n"
"   public Customer getCustomer() { return customer; }\n"
"   public void setCustomer(Customer customer) { this.customer = customer; }\n"
"   private Customer number;\n"
"}\n"
"\n"
"-- Table schema\n"
"|-------------| |----------| |---------------|\n"
"| Order       | | Customer | | Cust_Order    |\n"
"|-------------| |----------| |---------------|\n"
"| id          | | id       | | customer_id   |\n"
"| number      | |----------| | order_id      |\n"
"| customer_id |              | orders_number |\n"
"|-------------|              |---------------|"
msgstr ""

#. Tag: para
#: collection_mapping.xml:573
#, no-c-format
msgid ""
"We recommend you to migrate from <classname>@org.hibernate.annotations."
"MapKey</classname> / @org.hibernate.annotation.MapKeyManyToMany, "
"<literal><map-key-many-to-many> and <composite-"
"map-key></literal>. <map-key> is used for any "
"basic type, <literal><map-key-many-to-many> for an entity "
"reference and <literal><composite-map-key> for a composite "
"type."
msgstr ""
"Além do <literal><set>, existe também os elementos de "
"mapeamento <literal><list>, <map>, "
"<literal><bag>, <array> and "
"<literal><primitive-array>. O elemento <map> (optional): the name of the column holding the "
"collection index values."
msgstr ""
"<literal>column(opcional): o nome da coluna que mnatém os valores "
"do índice de coleção."

#. Tag: para
#: collection_mapping.xml:610
#, no-c-format
msgid ""
"<literal>formula (optional): a SQL formula used to evaluate the "
"key of the map."
msgstr ""
"<literal>formula (opcional): Uma fórmula SQL usada para avaliar a "
"chave ou o mapa."

#. Tag: para
#: collection_mapping.xml:615
#, no-c-format
msgid "<literal>type (required): the type of the map keys."
msgstr "<literal>type (requerido): o tipo de chaves de mapa."

#. Tag: title
#: collection_mapping.xml:623
#, fuzzy, no-c-format
msgid "map-key-many-to-many"
msgstr "Muitos-para-muitos"

#. Tag: programlisting
#: collection_mapping.xml:634
#, no-c-format
msgid ""
"<map-key-many-to-many\n"
"        column=\"column_name\"\n"
"        formula=\"any SQL expression\"\n"
"        class=\"ClassName\"\n"
"/>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:638
#, no-c-format
msgid ""
"<literal>column (optional): the name of the foreign key column for "
"the collection index values."
msgstr ""
"<literal>column (opcional): o nome de uma coluna de chave exterior "
"para os valores do índice de coleção."

#. Tag: para
#: collection_mapping.xml:643
#, no-c-format
msgid ""
"<literal>formula (optional): a SQ formula used to evaluate the "
"foreign key of the map key."
msgstr ""
"<literal>formula (opcional): uma fórmula SQ usada para avaliar a "
"chave exterior da chave do mapa."

#. Tag: para
#: collection_mapping.xml:648
#, no-c-format
msgid ""
"<literal>class (required): the entity class used as the map key."
msgstr ""
"<literal>class (requerido): a classe da entidade usada como chave "
"do mapa."

#. Tag: title
#: collection_mapping.xml:658
#, fuzzy, no-c-format
msgid "Collections of basic types and embeddable objects"
msgstr "Coleções de valores e associações muitos-para-muitos"

#. Tag: para
#: collection_mapping.xml:660
#, no-c-format
msgid ""
"In some situations you don't need to associate two entities but simply "
"create a collection of basic types or embeddable objects. Use the "
"<classname>@ElementCollection for this case."
msgstr ""

#. Tag: title
#: collection_mapping.xml:665
#, no-c-format
msgid ""
"Collection of basic types mapped via <classname>@ElementCollection annotation. If omitted the "
"collection table name defaults to the concatenation of the name of the "
"containing entity and the name of the collection attribute, separated by an "
"underscore. In our example, it would be <literal>User_nicknames."
msgstr ""

#. Tag: para
#: collection_mapping.xml:678
#, no-c-format
msgid ""
"The column holding the basic type is set using the <classname>@Column."
msgstr ""

#. Tag: para
#: collection_mapping.xml:683
#, no-c-format
msgid ""
"But you are not limited to basic types, the collection type can be any "
"embeddable object. To override the columns of the embeddable object in the "
"collection table, use the <classname>@AttributeOverride "
"annotation."
msgstr ""

#. Tag: title
#: collection_mapping.xml:689
#, no-c-format
msgid "@ElementCollection for embeddable objects"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:691
#, no-c-format
msgid ""
"@Entity\n"
"public class User {\n"
"   [...]\n"
"   public String getLastname() { ...}\n"
"\n"
"   @ElementCollection\n"
"   @CollectionTable(name=\"Addresses\", joinColumns=@JoinColumn(name="
"\"user_id\"))\n"
"   @AttributeOverrides({\n"
"      @AttributeOverride(name=\"street1\", column=@Column(name=\"fld_street"
"\"))\n"
"   })\n"
"   public Set<Address> getAddresses() { ... } \n"
"}\n"
"\n"
"@Embeddable\n"
"public class Address {\n"
"   public String getStreet1() {...}\n"
"   [...]\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:694
#, no-c-format
msgid "Such an embeddable object cannot contains a collection itself."
msgstr ""

#. Tag: para
#: collection_mapping.xml:698
#, no-c-format
msgid ""
"in <classname>@AttributeOverride, you must use the "
"<literal>value. prefix to override properties of the embeddable "
"object used in the map value and the <literal>key. prefix to "
"override properties of the embeddable object used in the map key."
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:704
#, no-c-format
msgid ""
"@Entity\n"
"public class User {\n"
"   @ElementCollection\n"
"   @AttributeOverrides({\n"
"      @AttributeOverride(name=\"key.street1\", column=@Column(name="
"\"fld_street\")),\n"
"      @AttributeOverride(name=\"value.stars\", column=@Column(name=\"fld_note"
"\"))\n"
"   })\n"
"   public Map<Address,Rating> getFavHomes() { ... }"
msgstr ""

#. Tag: para
#: collection_mapping.xml:708
#, no-c-format
msgid ""
"We recommend you to migrate from <classname>@org.hibernate.annotations."
"CollectionOfElements</classname> to the new @ElementCollection tag. For example:"
msgstr ""
"Para uma coleção com valores, utilizamos a tag <literal><element> (optional): the name of the column holding the "
"collection element values."
msgstr ""
"<literal>column (opcional): o nome da coluna que mantém os valores "
"do elemento da coleção."

#. Tag: para
#: collection_mapping.xml:739
#, no-c-format
msgid ""
"<literal>formula (optional): an SQL formula used to evaluate the "
"element."
msgstr ""
"<literal>formula (opcional): uma fórmula usada para avaliar o "
"elemento."

#. Tag: para
#: collection_mapping.xml:744
#, no-c-format
msgid "<literal>type (required): the type of the collection element."
msgstr "<literal>type (requerido): o tipo do elemento de coleção."

#. Tag: title
#: collection_mapping.xml:754
#, no-c-format
msgid "Advanced collection mappings"
msgstr "Mapeamentos de coleção avançados."

#. Tag: title
#: collection_mapping.xml:757
#, no-c-format
msgid "Sorted collections"
msgstr "Coleções escolhidas"

#. Tag: para
#: collection_mapping.xml:759
#, no-c-format
msgid ""
"Hibernate supports collections implementing <literal>java.util.SortedMapjava.util.SortedSet. With annotations you "
"declare a sort comparator using <literal>@Sort. You chose between "
"the comparator types unsorted, natural or custom. If you want to use your "
"own comparator implementation, you'll also have to specify the "
"implementation class using the <literal>comparator attribute. Note "
"that you need to use either a <classname>SortedSet or a "
"<classname>SortedMap interface."
msgstr ""

#. Tag: title
#: collection_mapping.xml:770
#, fuzzy, no-c-format
msgid "Sorted collection with @Sort"
msgstr "Coleções escolhidas"

#. Tag: programlisting
#: collection_mapping.xml:772
#, no-c-format
msgid ""
"@OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)\n"
"@JoinColumn(name=\"CUST_ID\")\n"
"@Sort(type = SortType.COMPARATOR, comparator = TicketComparator.class)\n"
"public SortedSet<Ticket> getTickets() {\n"
"    return tickets;\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:775
#, no-c-format
msgid ""
"Using Hibernate mapping files you specify a comparator in the mapping file "
"with <literal><sort>:"
msgstr ""

#. Tag: title
#: collection_mapping.xml:779
#, fuzzy, no-c-format
msgid "Sorted collection using xml mapping"
msgstr "Coleções escolhidas"

#. Tag: programlisting
#: collection_mapping.xml:781
#, no-c-format
msgid ""
"<set name=\"aliases\"\n"
"            table=\"person_aliases\" \n"
"            sort=\"natural\">\n"
"    <key column=\"person\"/>\n"
"    <element column=\"name\" type=\"string\"/>\n"
"</set>\n"
"\n"
"<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n"
"    <key column=\"year_id\"/>\n"
"    <map-key column=\"hol_name\" type=\"string\"/>\n"
"    <element column=\"hol_date\" type=\"date\"/>\n"
"</map>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:784
#, no-c-format
msgid ""
"Allowed values of the <literal>sort attribute are "
"<literal>unsorted, natural and the name of a "
"class implementing <literal>java.util.Comparator."
msgstr ""
"Valores permitidos da função<literal>sort sãounsortednatural e o nome de uma classe implementando "
"<literal>java.util.Comparator."

#. Tag: para
#: collection_mapping.xml:789
#, no-c-format
msgid ""
"Sorted collections actually behave like <literal>java.util.TreeSet "
"or <literal>java.util.TreeMap."
msgstr ""
"Coleções escolhidas, na verdade se comportam como <literal>java.util."
"TreeSet</literal> ou java.util.TreeMap."

#. Tag: para
#: collection_mapping.xml:794
#, fuzzy, no-c-format
msgid ""
"If you want the database itself to order the collection elements, use the "
"<literal>order-by attribute of set, "
"<literal>bag or map mappings. This solution is "
"implemented using <literal>LinkedHashSet or "
"<literal>LinkedHashMap and performs the ordering in the SQL query "
"and not in the memory."
msgstr ""
"Se você quiser que o próprio banco de dados ordene os elementos da coleção "
"use a função <literal>order-by do set, "
"<literal>bag ou mapeamentos map. Esta solução "
"está disponível somente sob JDK 1.4 ou versões posteriores e é implementada "
"usando <literal>LinkedHashSet ou LinkedHashMap attribute is an SQL ordering, "
"not an HQL ordering."
msgstr ""
"Note que o valor da função <literal>order-by é uma ordenação SQL e "
"não uma ordenação."

#. Tag: para
#: collection_mapping.xml:814
#, no-c-format
msgid ""
"Associations can even be sorted by arbitrary criteria at runtime using a "
"collection <literal>filter():"
msgstr ""
"Associações podem também ser escolhidas por algum critério arbritrário em "
"tempo de espera usando uma coleção <literal>filter():"

#. Tag: title
#: collection_mapping.xml:818
#, no-c-format
msgid "Sorting via a query filter"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:820
#, no-c-format
msgid ""
"sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list"
"();"
msgstr ""

#. Tag: title
#: collection_mapping.xml:825
#, no-c-format
msgid "Bidirectional associations"
msgstr "Associações Bidirecionais"

#. Tag: para
#: collection_mapping.xml:827
#, no-c-format
msgid ""
"A <emphasis>bidirectional association allows navigation from both "
"\"ends\" of the association. Two kinds of bidirectional association are "
"supported:"
msgstr ""
"Uma <emphasis>associação bidirecional permite a navegação de "
"ambos os \"lados\" da associação. Dois dos casos de associação bidirecional, "
"são suportados: "

#. Tag: term
#: collection_mapping.xml:831
#, no-c-format
msgid "one-to-many"
msgstr "Um-para-muitos"

#. Tag: para
#: collection_mapping.xml:834
#, no-c-format
msgid "set or bag valued at one end and single-valued at the other"
msgstr "conjunto ou bag de valor em um dos lados, valor único do outro "

#. Tag: term
#: collection_mapping.xml:840
#, no-c-format
msgid "many-to-many"
msgstr "Muitos-para-muitos"

#. Tag: para
#: collection_mapping.xml:843
#, no-c-format
msgid "set or bag valued at both ends"
msgstr "Conjunto ou bag com valor em ambos os lados"

#. Tag: para
#: collection_mapping.xml:848
#, no-c-format
msgid ""
"Often there exists a many to one association which is the owner side of a "
"bidirectional relationship. The corresponding one to many association is in "
"this case annotated by <literal>@OneToMany(mappedBy=...)"
msgstr ""

#. Tag: title
#: collection_mapping.xml:854
#, no-c-format
msgid "Bidirectional one to many with many to one side as association owner"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:857
#, no-c-format
msgid ""
"@Entity\n"
"public class Troop {\n"
"    @OneToMany(mappedBy=\"troop\")\n"
"    public Set<Soldier> getSoldiers() {\n"
"    ...\n"
"}\n"
"\n"
"@Entity\n"
"public class Soldier {\n"
"    @ManyToOne\n"
"    @JoinColumn(name=\"troop_fk\")\n"
"    public Troop getTroop() {\n"
"    ...\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:860
#, no-c-format
msgid ""
"<classname>Troop has a bidirectional one to many relationship "
"with <literal>Soldier through the troop "
"property. You don't have to (must not) define any physical mapping in the "
"<literal>mappedBy side."
msgstr ""

#. Tag: para
#: collection_mapping.xml:865
#, no-c-format
msgid ""
"To map a bidirectional one to many, with the one-to-many side as the owning "
"side, you have to remove the <literal>mappedBy element and set the "
"many to one <literal>@JoinColumn as insertable and updatable to "
"false. This solution is not optimized and will produce additional UPDATE "
"statements."
msgstr ""

#. Tag: title
#: collection_mapping.xml:872
#, fuzzy, no-c-format
msgid "Bidirectional associtaion with one to many side as owner"
msgstr "Associações bidirecionais com coleções indexadas"

#. Tag: programlisting
#: collection_mapping.xml:875
#, no-c-format
msgid ""
"@Entity\n"
"public class Troop {\n"
"    @OneToMany\n"
"    @JoinColumn(name=\"troop_fk\") //we need to duplicate the physical "
"information\n"
"    public Set<Soldier> getSoldiers() {\n"
"    ...\n"
"}\n"
"\n"
"@Entity\n"
"public class Soldier {\n"
"    @ManyToOne\n"
"    @JoinColumn(name=\"troop_fk\", insertable=false, updatable=false)\n"
"    public Troop getTroop() {\n"
"    ...\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:878
#, fuzzy, no-c-format
msgid ""
"How does the mappping of a bidirectional mapping look like in Hibernate "
"mapping xml? There you define a bidirectional one-to-many association by "
"mapping a one-to-many association to the same table column(s) as a many-to-"
"one association and declaring the many-valued end <literal>inverse=\"true\" "
"does not affect the operation of cascades as these are orthogonal concepts."
msgstr ""
"Mapear apenas uma das pontas da associação com <literal>inverse=\"true\" annotation. You also have to describe the "
"association table and the join conditions using the <literal>@JoinTable defines a name primary key (the \"other side\"). As seen "
"previously, the other side don't have to (must not) describe the physical "
"mapping: a simple <literal>mappedBy argument containing the owner "
"side property name bind the two."
msgstr ""

#. Tag: para
#: collection_mapping.xml:919
#, no-c-format
msgid ""
"As any other annotations, most values are guessed in a many to many "
"relationship. Without describing any physical mapping in a unidirectional "
"many to many the following rules applied. The table name is the "
"concatenation of the owner table name, <keycap>_ and the other side "
"table name. The foreign key name(s) referencing the owner table is the "
"concatenation of the owner table name, <keycap>_ and the owner "
"primary key column(s). The foreign key name(s) referencing the other side is "
"the concatenation of the owner property name, <keycap>_, and the "
"other side primary key column(s). These are the same rules used for a "
"unidirectional one to many relationship."
msgstr ""

#. Tag: title
#: collection_mapping.xml:932
#, no-c-format
msgid "Default values for <classname>@ManyToMany (uni-directional)"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:935
#, no-c-format
msgid ""
"@Entity\n"
"public class Store {\n"
"    @ManyToMany(cascade = CascadeType.PERSIST)\n"
"    public Set<City> getImplantedIn() {\n"
"        ...\n"
"    }\n"
"}\n"
"\n"
"@Entity\n"
"public class City {\n"
"    ... //no bidirectional relationship\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:938
#, no-c-format
msgid ""
"A <literal>Store_City is used as the join table. The "
"<literal>Store_id column is a foreign key to the StoreimplantedIn_id column is a foreign "
"key to the <literal>City table."
msgstr ""

#. Tag: para
#: collection_mapping.xml:943
#, no-c-format
msgid ""
"Without describing any physical mapping in a bidirectional many to many the "
"following rules applied. The table name is the concatenation of the owner "
"table name, <keycap>_ and the other side table name. The foreign "
"key name(s) referencing the owner table is the concatenation of the other "
"side property name, <keycap>_, and the owner primary key column(s). "
"The foreign key name(s) referencing the other side is the concatenation of "
"the owner property name, <keycap>_, and the other side primary key "
"column(s). These are the same rules used for a unidirectional one to many "
"relationship."
msgstr ""

#. Tag: title
#: collection_mapping.xml:955
#, no-c-format
msgid "Default values for <classname>@ManyToMany (bi-directional)"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:958
#, no-c-format
msgid ""
"@Entity\n"
"public class Store {\n"
"    @ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})\n"
"    public Set<Customer> getCustomers() {\n"
"        ...\n"
"    }\n"
"}\n"
"\n"
"@Entity\n"
"public class Customer {\n"
"    @ManyToMany(mappedBy=\"customers\")\n"
"    public Set<Store> getStores() {\n"
"        ...\n"
"    }\n"
"}"
msgstr ""

#. Tag: para
#: collection_mapping.xml:961
#, no-c-format
msgid ""
"A <literal>Store_Customer is used as the join table. The "
"<literal>stores_id column is a foreign key to the Storecustomers_id column is a foreign key "
"to the <literal>Customer table."
msgstr ""

#. Tag: para
#: collection_mapping.xml:966
#, fuzzy, no-c-format
msgid ""
"Using Hibernate mapping files you can map a bidirectional many-to-many "
"association by mapping two many-to-many associations to the same database "
"table and declaring one end as <emphasis>inverse."
msgstr ""
"Você deve especificar uma associação muitos-para-muitos bidirecional, "
"simplesmente mapeando as duas associações muitos-para-muitos para alguma "
"tabela de banco de dados e declarando um dos lados como <emphasis>inverso "
"são persistidas. Isto significa que o Hibernate tem duas representações na "
"memória para cada associação bidirecional, uma associação de A para B e uma "
"outra associação de B para A. Isto é mais fácil de compreender se você pensa "
"sobre o modelo de objetos do Java e como criamos um relacionamento muitos "
"para muitos em Java:"

#. Tag: title
#: collection_mapping.xml:992
#, fuzzy, no-c-format
msgid "Effect of inverse vs. non-inverse side of many to many associations"
msgstr "Coleções de valores e associações muitos-para-muitos"

#. Tag: programlisting
#: collection_mapping.xml:995
#, no-c-format
msgid ""
"category.getItems().add(item);           // The category now \"knows\" about "
"the relationship\n"
"item.getCategories().add(category);      // The item now \"knows\" about the "
"relationship\n"
"\n"
"session.persist(item);                   // The relationship won't be "
"saved!\n"
"session.persist(category);               // The relationship will be saved"
msgstr ""

#. Tag: para
#: collection_mapping.xml:998
#, no-c-format
msgid ""
"The non-inverse side is used to save the in-memory representation to the "
"database."
msgstr ""
"A outra ponta é usada para salvar a representação em memória à base de dados."

#. Tag: title
#: collection_mapping.xml:1003
#, no-c-format
msgid "Bidirectional associations with indexed collections"
msgstr "Associações bidirecionais com coleções indexadas"

#. Tag: para
#: collection_mapping.xml:1005
#, fuzzy, no-c-format
msgid ""
"There are some additional considerations for bidirectional mappings with "
"indexed collections (where one end is represented as a <literal><list>"
"</literal> or <map>) when using Hibernate mapping "
"files. If there is a property of the child class that maps to the index "
"column you can use <literal>inverse=\"true\" on the collection "
"mapping:"
msgstr ""
"Uma associação bidirecional onde um dos lados é representado por uma "
"<literal><list> ou <map> requer uma "
"consideração especial. Se houver uma propriedade da classe filha que faça o "
"mapeamento da coluna do índice sem problemas, pode-se continuar usando "
"<literal>inverse=\"true\" no mapeamento da coleção:"

#. Tag: title
#: collection_mapping.xml:1013
#, fuzzy, no-c-format
msgid "Bidirectional association with indexed collection"
msgstr "Associações bidirecionais com coleções indexadas"

#. Tag: programlisting
#: collection_mapping.xml:1015
#, no-c-format
msgid ""
"<class name=\"Parent\">\n"
"    <id name=\"id\" column=\"parent_id\"/>\n"
"    ....\n"
"    <map name=\"children\" inverse=\"true\">\n"
"        <key column=\"parent_id\"/>\n"
"        <map-key column=\"name\" \n"
"            type=\"string\"/>\n"
"        <one-to-many class=\"Child\"/>\n"
"    </map>\n"
"</class>\n"
"\n"
"<class name=\"Child\">\n"
"    <id name=\"id\" column=\"child_id\"/>\n"
"    ....\n"
"    <property name=\"name\" \n"
"        not-null=\"true\"/>\n"
"    <many-to-one name=\"parent\" \n"
"        class=\"Parent\" \n"
"        column=\"parent_id\"\n"
"        not-null=\"true\"/>\n"
"</class>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1018
#, no-c-format
msgid ""
"If there is no such property on the child class, the association cannot be "
"considered truly bidirectional. That is, there is information available at "
"one end of the association that is not available at the other end. In this "
"case, you cannot map the collection <literal>inverse=\"true\". "
"Instead, you could use the following mapping:"
msgstr ""
"Mas, se não houver nenhuma propriedade na classe filha, não podemos ver essa "
"associação como verdadeiramente bidirecional (há uma informação disponível "
"em um lado da associação que não está disponível no extremo oposto). Nesse "
"caso, nós não podemos mapear a coleção usando <literal>inverse=\"true\" with an association as its index:"
msgstr ""
"Há três meios possíveis de se mapear uma associação ternária. Uma é usar um "
"<literal>Map com uma associação como seu índice: "

#. Tag: title
#: collection_mapping.xml:1044
#, fuzzy, no-c-format
msgid "Ternary association mapping"
msgstr "Associações Ternárias"

#. Tag: programlisting
#: collection_mapping.xml:1046
#, no-c-format
msgid ""
"@Entity\n"
"public class Company {\n"
"   @Id \n"
"   int id;\n"
"   ...\n"
"   @OneToMany // unidirectional\n"
"   @MapKeyJoinColumn(name=\"employee_id\")\n"
"   Map<Employee, Contract> contracts;\n"
"}\n"
"\n"
"// or\n"
"\n"
"<map name=\"contracts\">\n"
"    <key column=\"employer_id\" not-null=\"true\"/>\n"
"    <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n"
"    <one-to-many class=\"Contract\"/>\n"
"</map>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1049
#, fuzzy, no-c-format
msgid ""
"A second approach is to remodel the association as an entity class. This is "
"the most common approach. A final alternative is to use composite elements, "
"which will be discussed later."
msgstr ""
"A segunda maneira é simplesmente remodelar a associação das classes da "
"entidade. Esta é a abordagem que utilizamos com mais freqüência. "

#. Tag: literal
#: collection_mapping.xml:1055
#, fuzzy, no-c-format
msgid "Using an <idbag>"
msgstr "<literal>Using an <idbag>"

#. Tag: para
#: collection_mapping.xml:1057
#, fuzzy, no-c-format
msgid ""
"The majority of the many-to-many associations and collections of values "
"shown previously all map to tables with composite keys, even though it has "
"been suggested that entities should have synthetic identifiers (surrogate "
"keys). A pure association table does not seem to benefit much from a "
"surrogate key, although a collection of composite values <emphasis>might. É por este motivo que o Hibernate provê "
"uma maneira de mapear uma associação muitos para muitos com uma coleção de "
"valores para uma tabela com uma chave substituta. "

#. Tag: para
#: collection_mapping.xml:1066
#, no-c-format
msgid ""
"The <literal><idbag> element lets you map a ListCollection) with bag semantics. For example:"
msgstr ""
"O elemento <literal><idbag> permite mapear um ListCollection) com uma semântica de bag. "
"Por exemplo:"

#. Tag: programlisting
#: collection_mapping.xml:1070
#, no-c-format
msgid ""
"<idbag name=\"lovers\" table=\"LOVERS\">\n"
"    <collection-id column=\"ID\" type=\"long\">\n"
"        <generator class=\"sequence\"/>\n"
"    </collection-id>\n"
"    <key column=\"PERSON1\"/>\n"
"    <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/"
">\n"
"</idbag>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1072
#, no-c-format
msgid ""
"An <literal><idbag> has a synthetic id generator, just like "
"an entity class. A different surrogate key is assigned to each collection "
"row. Hibernate does not, however, provide any mechanism for discovering the "
"surrogate key value of a particular row."
msgstr ""
"O <literal><idbag> possui um gerador de id sintético, igual "
"a uma classe de entidade. Uma chave substituta diferente é associada para "
"cada elemento de coleção. Porém, o Hibernate não provê de nenhum mecanismo "
"para descobrir qual a chave substituta de uma linha em particular."

#. Tag: para
#: collection_mapping.xml:1077
#, no-c-format
msgid ""
"The update performance of an <literal><idbag> supersedes a "
"regular <literal><bag>. Hibernate can locate individual rows "
"efficiently and update or delete them individually, similar to a list, map "
"or set."
msgstr ""
"Note que o desempenho de atualização de um <literal><idbag> "
"é melhor do que um <literal><bag> normal. O Hibernate pode "
"localizar uma linha individual eficazmente e atualizar ou deletar "
"individualmente, como um list, map ou set."

#. Tag: para
#: collection_mapping.xml:1082
#, no-c-format
msgid ""
"In the current implementation, the <literal>native identifier "
"generation strategy is not supported for <literal><idbag> "
"collection identifiers."
msgstr ""
"Na implementação atual, a estratégia de geração de identificador "
"<literal>native não é suportada para identificadores de coleção "
"usando o <literal><idbag>."

#. Tag: title
#: collection_mapping.xml:1103
#, no-c-format
msgid "Collection examples"
msgstr "Exemplos de coleções"

#. Tag: para
#: collection_mapping.xml:1105
#, no-c-format
msgid "This section covers collection examples."
msgstr "Esta sessão cobre os exemplos de coleções."

#. Tag: para
#: collection_mapping.xml:1107
#, no-c-format
msgid ""
"The following class has a collection of <literal>Child instances:"
msgstr ""
"A seguinte classe possui uma coleção de instâncias <literal>Child:"

#. Tag: title
#: collection_mapping.xml:1111
#, no-c-format
msgid ""
"Example classes <classname>Parent and Child relationship "
"using annotations"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1124
#, no-c-format
msgid ""
"public class Parent {\n"
"    @Id\n"
"    @GeneratedValue\n"
"    private long id;\n"
"\n"
"    @OneToMany\n"
"    private Set<Child> children;\n"
"\n"
"    // getter/setter\n"
"    ...\n"
"}\n"
"\n"
"\n"
"public class Child {\n"
"   @Id\n"
"   @GeneratedValue\n"
"   private long id;\n"
"   private String name;\n"
"\n"
"   \n"
"   // getter/setter\n"
"   ...\n"
"}"
msgstr ""

#. Tag: title
#: collection_mapping.xml:1128
#, no-c-format
msgid ""
"One to many unidirectional <classname>Parent-Child relationship "
"using mapping files"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1131
#, no-c-format
msgid ""
"<hibernate-mapping>\n"
"\n"
"    <class name=\"Parent\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <set name=\"children\">\n"
"            <key column=\"parent_id\"/>\n"
"            <one-to-many class=\"Child\"/>\n"
"        </set>\n"
"    </class>\n"
"\n"
"    <class name=\"Child\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <property name=\"name\"/>\n"
"    </class>\n"
"\n"
"</hibernate-mapping>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1134
#, no-c-format
msgid "This maps to the following table definitions:"
msgstr "Esse mapeamento gera a seguinte definição de tabelas"

#. Tag: title
#: collection_mapping.xml:1137
#, no-c-format
msgid ""
"Table definitions for unidirectional <classname>Parent-"
"<classname>Child relationship"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1141
#, no-c-format
msgid ""
"create table parent ( id bigint not null primary key )\n"
"create table child ( id bigint not null primary key, name varchar(255), "
"parent_id bigint )\n"
"alter table child add constraint childfk0 (parent_id) references parent"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1144
#, no-c-format
msgid ""
"If the parent is <emphasis>required, use a bidirectional one-to-"
"many association:"
msgstr ""
"Se o pai for <emphasis>obrigatório, use uma associação "
"bidirecional um para muitos:"

#. Tag: title
#: collection_mapping.xml:1148
#, no-c-format
msgid ""
"One to many bidirectional <classname>Parent-Child relationship "
"using annotations"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1151
#, no-c-format
msgid ""
"public class Parent {\n"
"    @Id\n"
"    @GeneratedValue\n"
"    private long id;\n"
"\n"
"    @OneToMany(mappedBy=\"parent\")\n"
"    private Set<Child> children;\n"
"\n"
"    // getter/setter\n"
"    ...\n"
"}\n"
"\n"
"\n"
"public class Child {\n"
"   @Id\n"
"   @GeneratedValue\n"
"   private long id;\n"
"\n"
"   private String name;\n"
" \n"
"   @ManyToOne\n"
"   private Parent parent;\n"
"\n"
"   \n"
"   // getter/setter\n"
"   ...\n"
"}"
msgstr ""

#. Tag: title
#: collection_mapping.xml:1155
#, no-c-format
msgid ""
"One to many bidirectional <classname>Parent-Child relationship "
"using mapping files"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1158
#, no-c-format
msgid ""
"<hibernate-mapping>\n"
"\n"
"    <class name=\"Parent\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <set name=\"children\" inverse=\"true\">\n"
"            <key column=\"parent_id\"/>\n"
"            <one-to-many class=\"Child\"/>\n"
"        </set>\n"
"    </class>\n"
"\n"
"    <class name=\"Child\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <property name=\"name\"/>\n"
"        <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id"
"\" not-null=\"true\"/>\n"
"    </class>\n"
"\n"
"</hibernate-mapping>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1161
#, no-c-format
msgid "Notice the <literal>NOT NULL constraint:"
msgstr "Repare na restrição <literal>NOT NULL:"

#. Tag: title
#: collection_mapping.xml:1164
#, no-c-format
msgid ""
"Table definitions for bidirectional <classname>Parent-"
"<classname>Child relationship"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1168
#, no-c-format
msgid ""
"create table parent ( id bigint not null primary key )\n"
"create table child ( id bigint not null\n"
"                     primary key,\n"
"                     name varchar(255),\n"
"                     parent_id bigint not null )\n"
"alter table child add constraint childfk0 (parent_id) references parent"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1171
#, fuzzy, no-c-format
msgid ""
"Alternatively, if this association must be unidirectional you can enforce "
"the <literal>NOT NULL constraint."
msgstr ""
"Uma outra alternativa, no caso de você insistir que esta associação deva ser "
"unidirecional, você pode declarar a restrição como <literal>NOT NULL<key>:"

#. Tag: title
#: collection_mapping.xml:1175
#, no-c-format
msgid ""
"Enforcing NOT NULL constraint in unidirectional relation using annotations"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1178
#, no-c-format
msgid ""
"public class Parent {\n"
"    @Id\n"
"    @GeneratedValue\n"
"    private long id;\n"
"\n"
"    @OneToMany(optional=false)\n"
"    private Set<Child> children;\n"
"\n"
"    // getter/setter\n"
"    ...\n"
"}\n"
"\n"
"\n"
"public class Child {\n"
"   @Id\n"
"   @GeneratedValue\n"
"   private long id;\n"
"   private String name;\n"
"\n"
"   \n"
"   // getter/setter\n"
"   ...\n"
"}"
msgstr ""

#. Tag: title
#: collection_mapping.xml:1182
#, no-c-format
msgid ""
"Enforcing NOT NULL constraint in unidirectional relation using mapping files"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1185
#, no-c-format
msgid ""
"<hibernate-mapping>\n"
"\n"
"    <class name=\"Parent\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <set name=\"children\">\n"
"            <key column=\"parent_id\" not-null=\"true\"/>\n"
"            <one-to-many class=\"Child\"/>\n"
"        </set>\n"
"    </class>\n"
"\n"
"    <class name=\"Child\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <property name=\"name\"/>\n"
"    </class>\n"
"\n"
"</hibernate-mapping>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1188
#, fuzzy, no-c-format
msgid ""
"On the other hand, if a child has multiple parents, a many-to-many "
"association is appropriate."
msgstr ""
"Por outro lado, se um filho puder ter os múltiplos pais, a associação "
"apropriada será muitos-para-muitos: "

#. Tag: title
#: collection_mapping.xml:1192
#, no-c-format
msgid ""
"Many to many <classname>Parent-Child relationship using "
"annotations"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1195
#, no-c-format
msgid ""
"public class Parent {\n"
"    @Id\n"
"    @GeneratedValue\n"
"    private long id;\n"
"\n"
"    @ManyToMany\n"
"    private Set<Child> children;\n"
"\n"
"    // getter/setter\n"
"    ...\n"
"}\n"
"\n"
"\n"
"public class Child {\n"
"   @Id\n"
"   @GeneratedValue\n"
"   private long id;\n"
"\n"
"   private String name;\n"
"\n"
"   \n"
"   // getter/setter\n"
"   ...\n"
"}"
msgstr ""

#. Tag: title
#: collection_mapping.xml:1199
#, no-c-format
msgid ""
"Many to many <classname>Parent-Child relationship using mapping "
"files"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1202
#, no-c-format
msgid ""
"<hibernate-mapping>\n"
"\n"
"    <class name=\"Parent\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <set name=\"children\" table=\"childset\">\n"
"            <key column=\"parent_id\"/>\n"
"            <many-to-many class=\"Child\" column=\"child_id\"/>\n"
"        </set>\n"
"    </class>\n"
"\n"
"    <class name=\"Child\">\n"
"        <id name=\"id\">\n"
"            <generator class=\"sequence\"/>\n"
"        </id>\n"
"        <property name=\"name\"/>\n"
"    </class>\n"
"\n"
"</hibernate-mapping>"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1205
#, no-c-format
msgid "Table definitions:"
msgstr "Definições das tabelas:"

#. Tag: title
#: collection_mapping.xml:1208
#, no-c-format
msgid "Table definitions for many to many releationship"
msgstr ""

#. Tag: programlisting
#: collection_mapping.xml:1210
#, no-c-format
msgid ""
"create table parent ( id bigint not null primary key )\n"
"create table child ( id bigint not null primary key, name varchar(255) )\n"
"create table childset ( parent_id bigint not null,\n"
"                        child_id bigint not null,\n"
"                        primary key ( parent_id, child_id ) )\n"
"alter table childset add constraint childsetfk0 (parent_id) references "
"parent\n"
"alter table childset add constraint childsetfk1 (child_id) references child"
msgstr ""

#. Tag: para
#: collection_mapping.xml:1213
#, fuzzy, no-c-format
msgid ""
"For more examples and a complete explanation of a parent/child relationship "
"mapping, see <xref linkend=\"example-parentchild\"/> for more information. "
"Even more complex association mappings are covered in the next chapter."
msgstr ""
"Para mais exemplos e um exemplo completo de mapeamento de relacionamento de "
"mestre/detalhe, consulte <xref linkend=\"example-parentchild\" />."

#~ msgid ""
#~ "Hibernate requires that persistent collection-valued fields be declared "
#~ "as an interface type. For example:"
#~ msgstr ""
#~ "O Hibernate requer que os campos de coleções de valor persistente sejam "
#~ "declarados como um tipo de interface. Por exemplo:"

#~ msgid "Collection mappings"
#~ msgstr "Mapeamento de coleção"

#~ msgid ""
#~ "There are quite a range of mappings that can be generated for collections "
#~ "that cover many common relational models. We suggest you experiment with "
#~ "the schema generation tool so that you understand how various mapping "
#~ "declarations translate to database tables."
#~ msgstr ""
#~ "Existem diversas variedades de mapeamento que podem ser gerados para as "
#~ "coleções, cobrindo muitos modelos relacionais comuns. Sugerimos que você "
#~ "faça o teste com a ferramenta de geração do esquema para obter uma idéia "
#~ "de como diversas declarações de mapeamento traduzem as tabelas de banco "
#~ "de dados. "

#~ msgid "Collection elements"
#~ msgstr "Elementos de coleção"

#~ msgid ""
#~ "The contained type is referred to as the <emphasis>collection element "
#~ "type</emphasis>. Collection elements are mapped by <"
#~ "element></literal> or <composite-element>, or "
#~ "in the case of entity references, with <literal><one-to-many><many-to-many>. The first two map "
#~ "elements with value semantics, the next two are used to map entity "
#~ "associations."
#~ msgstr ""
#~ "O tipo contido é referido como <emphasis>tipo de elemento de coleção<"
#~ "element></literal> ou <composite-element>,ou "
#~ "no caso de referências de entidade, com <literal><one-to-many><many-to-many>. Os primeiros dois, "
#~ "mapeiam elementos com semânticas de valor, os dois outros são usados para "
#~ "mapear associações de entidade."

#~ msgid ""
#~ "All collection mappings, except those with set and bag semantics, need an "
#~ "<emphasis>index column in the collection table. An index "
#~ "column is a column that maps to an array index, or <literal>ListMap key. The index of a "
#~ "<literal>Map may be of any basic type, mapped with <"
#~ "map-key></literal>. It can be an entity reference mapped with "
#~ "<literal><map-key-many-to-many>, or it can be a composite "
#~ "type mapped with <literal><composite-map-key>. The index "
#~ "of an array or list is always of type <literal>integer and is "
#~ "mapped using the <literal><list-index> element. The "
#~ "mapped column contains sequential integers that are numbered from zero by "
#~ "default."
#~ msgstr ""
#~ "Todos os mapeamentos de coleção, exceto aqueles com semânticas de "
#~ "conjunto e bag, precisam de uma <emphasis>coluna índice na "
#~ "tabela de coleção, uma coluna que mapeia para um índice matriz ou índice "
#~ "<literal>List ou chave de Map. O índice de "
#~ "um <literal>Map pode ser de qualquer tipo, mapeado com "
#~ "<literal><map-key>, pode ser uma referência de entidade "
#~ "mapeada com <literal><map-key-many-to-many>, ou pode ser "
#~ "um tipo composto, mapeado com <literal><composite-map-key> e é mapeado usando o elemento <"
#~ "list-index></literal>. As colunas mapeadas contém inteiros "
#~ "sequenciais, dos quais são numerados a partir do zero, por padrão. "

#~ msgid ""
#~ "Any collection of values or many-to-many associations requires a "
#~ "dedicated <emphasis>collection table with a foreign key column "
#~ "or columns, <emphasis>collection element column or columns, "
#~ "and possibly an index column or columns."
#~ msgstr ""
#~ "Quaisquer valores de coleção ou associação muitos-para-muitos requerem "
#~ "uma <emphasis>tabela de coleção dedicada, com uma coluna de "
#~ "chave exterior ou colunas, <emphasis>collection element column "
#~ "ou colunas e possivelmente uma coluna de índice ou colunas."

#~ msgid ""
#~ "A <emphasis>many-to-many association is specified using the "
#~ "<literal><many-to-many> element."
#~ msgstr ""
#~ "A <emphasis>associação muitos-para-muitos é especificada "
#~ "usando o elemento <literal><many-to-many>. "

#~ msgid ""
#~ "<literal>column (optional): the name of the element foreign key "
#~ "column."
#~ msgstr ""
#~ "<literal>column (opcional): o nome da coluna da chave exterior "
#~ "do elemento."

#~ msgid ""
#~ "<literal>formula (optional): an SQL formula used to evaluate "
#~ "the element foreign key value."
#~ msgstr ""
#~ "<literal>formula (opcional): uma fórmula SQL usada para avaliar "
#~ "o valor da chave exterior do elemento."

#~ msgid ""
#~ "<literal>fetch (optional - defaults to join of an entity and its many-to-many relationships "
#~ "to other entities, you would enable <literal>join fetching,not "
#~ "only of the collection itself, but also with this attribute on the "
#~ "<literal><many-to-many> nested element."
#~ msgstr ""
#~ "<literal>fetch (opcional - padrão para join único de uma entidade e suas relações muitos-"
#~ "para-muitos com outras entidades, você deverá ativar a busca "
#~ "<literal>join, não apenas a própria coleção, mas também este "
#~ "atributo no elemento aninhado <literal><many-to-many>."

#~ msgid ""
#~ "<literal>unique (optional): enables the DDL generation of a "
#~ "unique constraint for the foreign-key column. This makes the association "
#~ "multiplicity effectively one-to-many."
#~ msgstr ""
#~ "<literal>unique (opcional): ativa a geração DDl de uma "
#~ "restrição única para a coluna de chave exterior. Isto realiza "
#~ "efetivamente a multiplicidade da associação um-para-muitos."

#~ msgid ""
#~ "<literal>not-found (optional - defaults to exception will treat a missing row as a null "
#~ "association."
#~ msgstr ""
#~ "<literal>not-found (opcional - padrão para exception tratará a "
#~ "linha faltante como uma associação nula. "

#~ msgid ""
#~ "<literal>property-ref (optional): the name of a property of the "
#~ "associated class that is joined to this foreign key. If not specified, "
#~ "the primary key of the associated class is used."
#~ msgstr ""
#~ "<literal>property-ref (opcional): o nome de uma propriedade de "
#~ "classe associada que é unida a esta chave exterior. caso não "
#~ "especificada, a chave primária da classe associada será usada."

#~ msgid "Here are some examples."
#~ msgstr "Segue abaixo alguns exemplos."

#~ msgid "A set of strings:"
#~ msgstr "Um conjunto de strings:"

#~ msgid ""
#~ "A bag containing integers with an iteration order determined by the "
#~ "<literal>order-by attribute:"
#~ msgstr ""
#~ "Uma bag contendo inteiros com uma ordem de iteração determinada pelo "
#~ "atributo <literal>order-by):"

#~ msgid "An array of entities, in this case, a many-to-many association:"
#~ msgstr ""
#~ "Uma matriz de entidades, neste caso, uma associação muitos-para-muitos: "

#~ msgid "A map from string indices to dates:"
#~ msgstr "Um mapa desde índices de strigs até datas:"

#~ msgid "A list of components (this is discussed in the next chapter):"
#~ msgstr "Uma lista de componentes (isto será discutido no próximo capítulo):"

#~ msgid "One-to-many associations"
#~ msgstr "Associações um-para-muitos"

#~ msgid ""
#~ "A <emphasis>one-to-many association links the tables of two "
#~ "classes via a foreign key with no intervening collection table. This "
#~ "mapping loses certain semantics of normal Java collections:"
#~ msgstr ""
#~ "Uma <emphasis>associação um para muitos liga as tabelas das "
#~ "duas classes através de uma chave exterior, sem a intervenção da tabela "
#~ "de coleção. Este mapeamento perde um pouco da semântica das coleções "
#~ "normais do Java: "

#~ msgid ""
#~ "The following example shows a map of <literal>Part entities by "
#~ "name, where <literal>partName is a persistent property of "
#~ "<literal>Part. Notice the use of a formula-based index:"
#~ msgstr ""
#~ "Este exemplo demonstra um mapa das entidades <literal>Part por "
#~ "nome, onde <literal>partName é uma propriedade persistente de "
#~ "<literal>Part. Note que o uso de um índice baseado em fórmula:"

#~ msgid ""
#~ "Hibernate supports collections implementing <literal>java.util.SortedMapjava.util.SortedSet. You must specify a "
#~ "comparator in the mapping file:"
#~ msgstr ""
#~ "O Hibernate suporta a implementação de coleções <literal>java.util."
#~ "SortedMap</literal> e java.util.SortedSet. Você deve "
#~ "especificar um comparador no arquivo de mapeamento:"

#~ msgid ""
#~ "A final alternative is to use composite elements, which will be discussed "
#~ "later."
#~ msgstr ""
#~ "Uma alternativa final é usar os elementos compostos, que nós discutiremos "
#~ "mais tarde. "

#~ msgid ""
#~ "Even more complex association mappings are covered in the next chapter."
#~ msgstr ""
#~ "Até mesmo o mapeamento de associações mais complexos serão discutimos no "
#~ "próximo capítulo."

Other Hibernate examples (source code examples)

Here is a short list of links related to this Hibernate collection_mapping.po source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.