Dali Java Persistence Tools User Guide Release 3.2 Release 3.2 |
|
Wizards |
Preferences |
Home > User Guide > Reference > Property pages
This section includes information each property page in the following views:
The JPA Details view displays the persistence information for the currently selected entity and contains the following tabs:
Entity Type
Clicking the name of the mapping type, which is represented as a hyperlink, invokes the Mapping Type Selection dialog. Use this dialog to specify the type of entity: Mapped Superclass, Embeddable or the default mapping type.
Additional Information
Depending on the entity type, the following additional areas will be available:
This table lists the Entity information fields available in the JPA Details view for an Entity.
Property | Description | Default |
---|---|---|
Table |
The default database table information for this entity. These fields can be overridden by the information in the Attribute Overrides area. |
|
Name |
The name of the primary database table associated with the entity. |
|
Catalog |
The database catalog that contains the Table. |
As defined in |
Schema |
The database schema that contains the Table. |
As defined in |
Name |
The name of this entity. By default, the class name is used as the entity name. |
|
Access |
Specify how the entity its access instance variables.
Note: This field is for display only, based on the properties in the |
Field |
ID class |
Click Browse and select the primary key for the entity. Clicking the field name, which is represented as a hyperlink, allows you to create a new class. |
Related tasks
Related reference
This table lists the Embeddable information fields available in the JPA Details view for Embeddable entity type.
Property | Description | Default |
---|---|---|
Access |
Specify how the entity its access instance variables.
Note: This field is for display only, based on the properties in the |
Field |
Related tasks
Related reference
This table lists the Embeddable information fields available in the JPA Details view for Mapped superclass entity type.
Property | Description | Default |
---|---|---|
Access |
Specify how the entity its access instance variables.
Note: This field is for display only, based on the properties in the |
Field |
ID class |
Click Browse and select the primary key for the entity. Clicking the field name, which is represented as a hyperlink, allows you to create a new class. |
Related tasks
Related reference
This table lists the Caching information fields available in the JPA Details view for each entity type.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Cachable |
Specifies if the entity is cachable. This field corresponds to the |
True |
|
Type |
Select one of the following as the Default Cache Type:
|
Weak with Soft Subcache |
|
Size |
Defines the size of cache to use (number of objects). |
100 |
|
Advanced |
|||
Expiry |
Enables the expiration of the cached instance after a fixed period of time (milliseconds). Queries executed against the cache after this will be forced back to the database for a refreshed copy. |
No expiry |
|
Always refresh |
Specifies if all queries that go to the database should always refresh the cache. |
False |
|
Refresh only if newer |
Specifies if all queries that go to the database should refresh the cache only if the data received from the database by a query is newer than the data in the cache (as determined by the optimistic locking field). Notes:
|
False |
|
Disable hits |
Specifies if all queries should bypass the cache for hits, but still resolve against the cache for identity. This forces all queries to hit the database. |
False |
|
Coordination type |
Specify the cache coordination mode:
|
Send Object Changes |
|
Existence checking |
Specify how Dali should check to determine if an entity is new or exists.
|
Check Cache then Database |
Related reference
"Cache" in Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_cache.htm
Use the queries area of the JPA Details view to create named queries and named native queries. Refer to "Creating queries" for additional information.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Queries |
Displays the existing Named and Native queries. Click Add to add a named or named native query by using the Add Query dialog. |
||
Named Queries |
|||
Name |
Name of the query. |
||
Query |
The query SQL. |
||
Lock mode |
Specify the JPA locking policy.
|
None |
|
Native Queries |
|||
Name |
Name of the query. |
||
Result class |
The class of the result. Note: This field appears for Native Named Queries only. |
||
Query |
The query SQL. |
||
Query hints |
Displays the existing query hints (Name and Value). Click Add to add a new query hint. |
Related tasks
Related reference
Related concepts
"Query Language" in the JPA Specification
http://jcp.org/en/jsr/detail?id=317
This table lists the fields available on the Inheritance area in the JPA Details view for each entity type.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Strategy |
Specify the strategy to use when mapping a class or class hierarchy:
This field corresponds to the |
Single table |
|
Specify the discriminator value used to differentiate an entity in this inheritance hierarchy. The value must conform to the specified Discriminator Type. |
|
||
These fields are available when using a Single or Joined inheritance strategy. This field corresponds to the Use the Details area to define the Length and Column definition of this Discriminator Column. |
|||
Name |
Name of the discriminator column |
|
|
Type |
Set this field to set the discriminator type to |
String |
|
Length |
The column length for String-based discriminator types. |
0 |
|
Column definition |
The SQL fragment that is used when generating the DDL for the discriminator column. |
|
|
Primary Key Join Columns |
Use to override the default primary key join columns. Select Override Default, then click Add to select new Join Column with the Add Primary Key Join Column dialog. This field corresponds with @ |
|
Refer to "Specifying entity inheritance" for additional information.
Related tasks
Related reference
Use the Attribute Overrides area in the JPA Details view to override the default settings specified in the Entity area of an attribute. Attribute overrides generally override/configure attributes that are inherited or embedded.
This table lists the Attribute override fields available in the JPA Details view for each entity type.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Attribute Overrides |
Specify a property or field to be overridden (from the default mappings). Select Override Default. |
|
|
Join Columns |
|
Related tasks
Related reference
Use the Multitenancy area in the JPA Details view to specify that a given entity is shared among multiple tenants of an application.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Multitenancy strategy |
Specify the multitenant strategy to use:
|
Single table |
|
Include criteria |
Specify if the database requires the tenant criteria to be added to the |
True |
|
Tenant descriptor columns |
Use to limit what a persistence context can access in single-table mulitenancy |
||
Override default |
|||
Name |
The name of column to be used for the tenant discriminator. |
eclipselink.tenant-id |
|
Table |
The name of the table that contains the column. |
||
Context property |
The name of the context property to apply to the tenant discriminator column. |
||
Discriminator type |
The type of object/column to use as a class discriminator:
|
String |
|
Length |
The column length for String-based discriminator types. |
||
Column definition |
The SQL fragment that is used when generating the DDL for the discriminator column. |
||
Primary key |
Specifies that the tenant discriminator column is part of the primary key of the tables. |
False |
Related reference
"Multitenant" in Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_multitenant.htm
Use the Primary Key Generation area in the JPA Details view to specify how to generate a primary key for a given entity.
Related reference
Use the Secondary Tables area in the JPA Details view to associate additional tables with an entity. Use this area if the data associated with an entity is spread across multiple tables.
Refer to "Specifying additional tables" for additional information.
Related tasks
Related reference
Use the Converter area in the JPA Details view to specify a way to modify data value(s) during the reading and writing of a mapped attribute.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Converters |
Click Add and use the Add Converter dialog to create a new converter.
|
||
Name |
The |
||
Class |
The class of your converter. This class must implement the Appears for Custom and Struct converters only. |
||
Data type |
The type stored in the database. Appears for Object Type and Type converters only. |
||
Object type |
The type stored on the entity. Appears for Object Type and Type converters only. |
||
Conversion values |
The array of conversion values (instances of Appears for Object Type converters only. |
||
Default object value |
Set the value of this attribute to the default object value. Note that this argument is for dealing with legacy data if the data value is missing. Appears for Object Type converters only. |
Related reference
"Converter" in Java Persistence API (JPA) Extensions Reference for EclipseLink
http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm
Use the Advanced area in the JPA Details view to configure additional settings for an entity.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Read-only |
Specifies if a class is read-only. |
False |
|
Customizer class |
Specifies a class that implements |
True |
|
Change tracking |
Specifies the
|
Auto |
Related reference
"Read Only" and "ChangeTracking" in Java Persistence API (JPA) Extensions Reference for EclipseLink
http://eclipse.org/eclipselink/documentation/2.4/jpa/
The JPA Details view displays the persistence information for the currently selected mapped attribute and contains the following areas:
Mapping Type
Additional Information
Depending on the mapping type, the following additional areas will be available:
Basic mappings also include the following areas:
Property | Description | Default |
---|---|---|
Target class |
The class (basic or embeddable) that is the element type of the collection. |
|
Fetch |
Defines how data is loaded from the database:
|
Lazy |
Join fetch |
The type of fetch to use:
|
None |
Collection Table |
||
Name |
Name of the database table used for the mapping. |
|
Schema |
Database schema of the Collection Table. |
|
Catalog |
Database Catalog of the Collection Table. |
|
Join Columns |
||
Override default |
Click Add to create a new join column, by using the Add Join Column dialog. |
0 |
Element collection mappings also include the following areas:
ID mappings also include the following areas:
Property | Description | Default |
---|---|---|
Target entity |
The persistent entity to which the attribute is mapped. |
|
Fetch |
Defines how data is loaded from the database:
|
Lazy |
Join fetch |
The type of fetch to use:
|
None |
Cascade |
Specify which operations are propagated throughout the entity.
|
True |
One-to-many mappings also include the following areas:
Property | Description | Default |
---|---|---|
Target entity |
The persistent entity to which the attribute is mapped. You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced. |
null |
Fetch |
Defines how data is loaded from the database:
|
Lazy |
Join fetch |
The type of fetch to use:
|
|
Optional |
Specifies if this field is can be null. |
True |
Cascade |
Specify which operations are propagated throughout the entity.
|
True |
Many-to-one mappings also include the following areas:
Property | Description | Default |
---|---|---|
Target entity |
The persistent entity to which the attribute is mapped. |
|
Fetch |
Defines how data is loaded from the database:
|
Lazy |
Join fetch |
The type of fetch to use:
|
|
Private owned |
Specify that a relationship is privately owned; target object is a dependent part of the source object and is not referenced by any other object and cannot exist on its own. |
|
Orphan removal |
False |
|
Cascade |
Specify which operations are propagated throughout the entity.
|
True |
One-to-many mappings also include the following areas:
Property | Description | Default |
---|---|---|
Target entity |
The persistent entity to which the attribute is mapped. |
|
Fetch |
Defines how data is loaded from the database:
|
Eager |
Join fetch |
The type of fetch to use:
|
|
Optional |
Specifies if this field is can be null. |
True |
Private owned |
Specify that a relationship is privately owned; target object is a dependent part of the source object and is not referenced by any other object and cannot exist on its own. |
False |
Orphan removal |
False |
|
Cascade |
Specify which operations are propagated throughout the entity.
|
True |
One-to-one mappings also include the following areas:
Version mappings also include the following areas:
Property | Description | Available for Mapping Type |
---|---|---|
Default |
||
Specify if the field is mapped to This field corresponds to the |
|
|
Specifies if this field is one of the following:
This field corresponds to the |
||
Specify how to persist enumerated constraints if the
This field corresponds to the |
|
|
Converted |
Converter name:
|
Use this area to specify a custom converter for modification of the data value(s) during the reading and writing of a mapped attribute.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Converters |
Click Add and use the Add Converter dialog to create a new converter.
|
Basic mapping, Element collection mapping, ID mapping, Many-to-many mapping, One-to-many mapping, and Version mapping |
|
Name |
Name of the converter. |
||
Class |
Appears for Custom and Struct converters only. |
||
Data type |
Appears for Object Type and Type converters only. |
||
Object type |
Appears for Object Type and Type converters only. |
||
Conversion values |
Appears for Object Type converters only. |
||
Default object value |
Appears for Object Type converters only. |
Related reference
"Converter" in Java Persistence API (JPA) Extensions Reference for EclipseLink
http://eclipse.org/eclipselink/documentation/2.4/jpa/extensions/a_converter.htm
Specify the default order for objects returned from a query. These options correspond to the @OrderBy
annotation.
Property | Description | Default | Available for Entity Type |
---|---|---|---|
Name |
Element collection mapping, Many-to-many mapping, and One-to-many mapping |
||
Primary key |
|||
Custom |
|||
Order column |
|||
Insertable |
Specify if the column is included in SQL |
True |
|
Updatable |
Specify if the column is included in SQL |
True |
|
Nullable |
Specify if the database column is nullable |
True |
|
Column definition |
The SQL fragment that used to generate the DDL for the column |
Generated SQL to create a column of the inferred type |
Use this area to specify a mapped column for joining an entity association. By default, the mapping is assumed to have a single join.
Property | Description | Available for Mapping Type |
---|---|---|
Mapped by |
The field in the database table that "owns" the relationship. This field is required only on the non-owning side of the relationship. |
Many-to-many mapping, One-to-many mapping, and One-to-one mapping |
Attribute |
||
Primary key join columns |
|
|
Join columns |
By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore. Select Override Default, then Add, Edit, or Remove the join columns. |
Many-to-one mapping, One-to-many mapping, and One-to-one mapping |
Join table |
Many-to-many mapping, Many-to-one mapping, One-to-many mapping, and One-to-one mapping |
|
Name |
Name of the join table that contains the foreign key column.You must specify the join table on the owning side. By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore. |
|
Schema |
Schema of the table |
|
Catalog |
Catalog of the table |
|
Join columns |
The foreign key columns of the join table which reference the primary table of the entity owning the association. (that is, the owning side of the association). |
|
Inverse join columns |
The foreign key columns of the join table which reference the primary table of the entity that does not own the association. (that is, the inverse side of the association). |
This table lists the fields available in the Primary Key Generation area in JPA Details view for ID mapping types.
Property | Description | Default |
---|---|---|
Primary Key Generation |
These fields define how the primary key is generated. These fields correspond to the |
Generated Value |
Strategy |
|
Auto |
Generator Name |
Unique name of the generated value. |
|
Table Generator |
These fields define the database table used for generating the primary key and correspond to the These fields apply only when Strategy = Table. |
|
Name |
Unique name of the generator. |
|
Table |
Database table that stores the generated ID values. |
|
Schema |
Schema of the table |
|
Catalog |
Catalog of the table |
|
Primary Key Column |
The column in the table generator's Table that contains the primary key. |
|
Value Column |
The column that stores the generated ID values. |
|
Primary Key Column Value |
The value for the Primary Key Column in the generator table. |
|
Allocation size |
||
Initial value |
||
Sequence Generator |
These fields define the specific sequence used for generating the primary key and correspond to the These fields apply only when Strategy = Sequence. |
|
Name |
Name of the sequence table to use for defining primary key values. |
|
Sequence |
Unique name of the sequence. |
|
Schema |
||
Catalog |
||
Allocation size |
||
Initial value |
Related tasks
Related reference
The JPA Details view displays the default mapping and persistence information for the project and contains the following areas:
Converters (when using EclipseLink)
These defaults can be overridden by the settings on a specific entity or mapping.
This table lists the Entity Mappings fields available in the JPA Details view for each entity type.
Property | Description | Default |
---|---|---|
Package |
The Java package that contains the persistent entities. Click Browse and select the package |
|
Schema |
The database schema that contains the Table. This field corresponds to the |
|
Catalog |
The database catalog that contains the Table. This field corresponds to the |
|
Access |
Specify the default access method for the variables in the project:
This field corresponds to the |
Related tasks
Related reference
This table lists the Persistence Unit information fields available in the JPA Details view for each entity type. These fields are contained in the <persistence-unit-metadata>
element in the orm.xml
file.
Property | Description | Default |
---|---|---|
XML Mapping Data Complete |
Specifies that the Java classes in this persistence unit are fully specified by their metadata. Any annotations will be ignored. This field corresponds to the |
|
Cascade Persist |
Adds cascade-persist to the set of cascade options in entity relationships of the persistence unit. This field corresponds to the |
|
Schema |
The database schema that contains the Table. This field corresponds to the |
|
Catalog |
The database catalog that contains the Table. This field corresponds to the |
|
Access |
Specify how the entity its access instance variables.
|
|
Deliminated identifiers |
Related tasks
Related reference
This table lists the Generator fields available in the JPA Details view for the orm.xml
file.
Property | Description | Default |
---|---|---|
Generators |
Click Add to create a new table or sequence generator, or select an existing generator and click Remove, to add or remove a generator. |
|
Sequence Generators |
||
Name |
||
Sequence |
||
Schema |
||
Catalog |
||
Allocation size |
50 |
|
Initial value |
1 |
|
Table Generators |
||
Name |
||
Table |
||
Schema |
||
Catalog |
||
Primary key column value |
||
Allocation size |
50 |
|
Initial value |
1 |
Related tasks
Related reference
This table lists the Query information fields available in the JPA Details view for the orm.xml
file.
Property | Description | Default |
---|---|---|
Queries |
Displays the existing Named and Native queries. Click Add to add a named query, or Add Native for a native query. For named queries, enter the query in the Query field. For native queries, select a result class, then enter the query in the Query field. |
|
Named Queries |
||
Name |
||
Query |
||
Lock mode |
None |
|
Native Queries |
||
Name |
||
Result class |
||
Query |
||
Query Hints |
Displays the existing query hints (Name and Value). Click Add to add a new query hint. |
Related tasks
Related reference
The Converters information in the JPA Details view applies only when using EclipseLink.
Click Add to create a new converter, using the Add Converter dialog.
Related reference
The JPA Structure view displays an outline of the structure (its attributes and mappings) of the entity that is currently selected or opened in the editor. The structural elements shown in the outline are the entity and its fields.
Related reference
The persistence.xml Editor provides an interface that enables you to update the persistence.xml
file. For projects using the EclipseLink platform, the perisistence.xml
Editor consists of the following pages:
For projects using the Generic platform, the following subset of these pages is available:
The following table lists properties available in the General page of the persistence.xml Editor.
Property | Description | Default |
---|---|---|
General |
||
Name |
Enter the name of the persistence unit. Defines the |
The project name |
Enter the name of the persistence provider. Defines the |
Determined by the server |
|
Description |
Enter a description for this persistence unit. This is an optional property. Defines the |
|
Classes |
Click Add to add a new class, or select an existing class and click Remove, to add or remove the classes managed through the persistence unit. Defines the Select a class and click Open to modify the class in the editor. |
|
Exclude Unlisted Classes |
Select to include all annotated entity classes in the root of the persistence unit. Defines the |
False |
Files |
Click Add to select an XML mapping file, or select an existing file and click Remove, to add or remove an object/relational mapping XML files that define the classes to be managed by the persistence unit. Defines the |
|
Exclude default EclipseLink XML mapping file |
Select to include all annotated EclipseLink mapping files. Defines the |
False |
JAR Files |
||
Files |
Click Add to select a JAR file, or select an existing file and click Remove, to add or remove JAR files and libraries in the persistence unit. |
The following table lists the properties available in the Connection page of the persistence.xml Editor.
Property | Description | Default |
---|---|---|
Specify if the connection for this persistence unit uses one of the following transaction types:
|
JTA |
|
Specify the use of batch writing to optimize transactions with multiple write operations. Set the value of this property into the session at deployment time. Note: This property applies when used both in a Java SE and Java EE environment. The following are the valid values for oracle.toplink.config.BatchWriting:
|
None |
|
Statement caching |
Specify if the query caches its JDBC statement. If enabled, you can also set the number of statements to cache. |
50 |
Native SQL |
Specify if Dali includes platform-specific (that is, "native") SQL statements. If false, Dali uses generic SLQ. |
False |
Database |
||
JTA Data Source Name |
If you selected JTA as the transaction type, then enter the name of the default JTA data source for the persistence unit. |
|
Non-JTA Data Source Name |
If you selected Resource Local as the transaction type, then enter the name of the non-JTA data source. This property is not available for projects using the Generic platform. |
|
EclipseLink connection pool |
Define the connection pool driver, URL, user name and password. These properties are note available for projects using the Generic platform. |
|
Bind parameters |
Control whether or not the query uses parameter binding. Note: This property applies when used in a Java SE environment. This property is not available for projects using the Generic platform. |
True |
Read Connection |
The maximum and minimum number of connections allowed in the JDBC read connection pool. Note: These property apply when used in a Java SE environment. These properties are not available for projects using the Generic platform |
Minimum: 2 Maximum 2 |
Write Connection |
The maximum and minimum number of connections allowed in the JDBC read connection pool. Note: These property apply when used in a Java SE environment. These properties are not available for projects using the Generic platform |
Minimum: 5 Maximum 10 |
Exclusive connections |
These fields are available only when Transaction Type is Local Resource. |
|
Exclusive connection mode |
Specify when Dali performs reads through the write connection.
|
Transactional |
Lazy connection acquisition |
Specify if Dali acquires write connections lazily. |
True |
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
The following table lists the properties available in the Customization page of the persistence.xml Editor.
Property | Description | Default |
---|---|---|
Weaving |
Specifies if weaving of the entity classes is performed. The EclipseLink JPA persistence provider uses weaving to enhance JPA entities for such properties as lazy loading, change tracking, fetch groups, and internal optimizations. Select from the following options:
|
Weave Dynamically |
Lazy |
Select this option to enable lazy weaving. |
True |
Fetch Groups |
Select this option to enable fetch groups through weaving. Set this option to false if:
Set this property to false for platforms where it is not supported. |
True |
Internal |
Specify if Dali uses internal optimizations through weaving. If enabled, enables lazy one-to-one and many-to-one mappings through weaving. |
True |
Eager |
Specify if Dali uses indirection on eager relationships. |
False |
Change Tracking |
Select this option to use weaving to detect which fields or properties of the object change. |
True |
Validation only |
Specify if Dali should validate deployments by initializing descriptors but not connecting to the data source. |
True |
Mapping files schema validation |
False |
|
Throw exceptions |
Select this option to set EclipseLink to throw an exception or log a warning when it encounters a problem with any of the files listed in a persistence.xml file |
True |
Exception handler |
Select (or create) a Java class (that implements the |
|
Session Customizer |
Select a session customizer class: a Java class that implements the |
|
Profiler |
Specify which performance profiler to use in order to capture runtime statistics.
|
NoProfiler |
Note: This page is not available for projects using the Generic platform. |
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
This table lists the properties of the Caching page of the persistence.xml Editor.
Property | Description | Default |
---|---|---|
Shared cache mode |
Select one of the following as the shared cache mode:
|
Disable selective |
Default Cache Type |
Select one of the following as the Default Cache Type:
|
Weak with soft subcache |
Default Cache Size |
Set the size (maximum number of objects) of the cache. |
100 |
Flush clear cache |
Select one of the following as the Default Cache Type:
|
Drop Invalidate |
Note: This page is not available for projects using the Generic platform. |
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
This table lists the properties of the Logging page of the persistence.xml Editor.
Note: This page is not available for projects using the Generic platform. |
Property | Description | Default |
---|---|---|
Logging Level |
Specifies the amount and detail of log output by selecting the log level (in ascending order of information): The following are the valid values for the
Example: <property name="eclipselink.logging.level" value="INFO"/> |
Info |
Control whether the timestamp is logged in each log entry. The following are the valid values:
Example: <property name="eclipselink.logging.timestamp" value="false"/> |
True |
|
Control whether a thread identifier is logged in each log entry. The following are the valid values:
|
True |
|
Session |
Control whether an EclipseLink session identifier is logged in each log entry. The following are the valid values:
Example: <property name="eclipselink.logging.session" value="false"/> |
true |
Exceptions |
Control whether the exceptions thrown from within the EclipseLink code are logged prior to returning the exception to the calling application. Ensures that all exceptions are logged and not masked by the application code. The following are the valid values:
Example: <property name="eclipselink.logging.exceptions" value="true"/> |
false |
Log file |
Specify a file location for the log output (instead of the standard out). Example: <property name="eclipselink.logging.file" value="C:\myout\" /> |
stdout |
Logger |
Select the type of logger to use: The following are the valid values:
Example: <property name="eclipselink.logging.logger" value="acme.loggers.MyCustomLogger" /> |
DefaultLogger |
Logging Categories |
You can also specify the logging level for the following specific categories:
|
Info |
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
This table lists the properties of the Options page of the persistence.xml Editor.
Note: This page is not available for projects using the Generic platform. |
Property | Description | Default |
---|---|---|
Session Options |
||
Session Name |
Specify the name by which the EclipseLink session is stored in the static session manager. Use this option if you need to access the EclipseLink shared session outside of the context of the JPA or to use a pre-existing EclipseLink session configured through a EclipseLink Valid values: a valid EclipseLink session name that is unique in a server deployment. Example: <property name="eclipselink.session-name" value="MySession"/> |
|
Sessions XML |
Specify persistence information loaded from the EclipseLink session configuration file ( You can use this option as an alternative to annotations and deployment XML. If you specify this property, EclipseLink will override all class annotation and the object relational mapping from the Indicate the session by setting the Note: If you do not specify the value for this property, Valid values: the resource name of the sessions XML file. Example: <property name="toplink.session-xml" value="mysession.xml"/> |
|
Target Database |
Select the target database. You can also set the value to the fully qualified class name of a subclass of the Example: <property name="eclipselink.target-database" value="Oracle"/> |
Auto |
Target Server |
Select the target server for your JPA application. Example: <property name="eclipselink.target-server" value="OC4J_10_1_3"/> |
None |
Event Listener |
Specify a descriptor event listener to be added during bootstrapping. Valid values: qualified class name for a class that implements the Example: <property name="eclipselink.session-event-listener" value="mypackage.MyClass.class"/> |
|
Include Descriptor Queries |
Enable or disable the default copying of all named queries from the descriptors to the session. These queries include the ones defined using EclipseLink API, descriptor amendment methods, and so on. |
True |
Miscellaneous Options |
||
Temporal mutable |
Specify if all Example: <property name="eclipselink.temporal.mutable" value="true"/> |
False |
Lock timeout |
5 |
|
Query timeout |
5 |
|
Validation mode |
Auto |
|
Validate pre-persist group |
||
Validate pre-update group |
||
Validate pre-remove group |
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
This table lists the properties of the Schema Generation page of the persistence.xml Editor.
Note: This page is not available for projects using the Generic platform. |
Property | Description | Default |
---|---|---|
DDL Generation Type |
Select the type of DDL generation:
|
None |
Output Mode |
Select the DDL generation target:
|
|
DDL Generation Location |
Specify where EclipseLink writes DDL output. Specify a file specification to a directory in which you have write access. The file specification may be relative to your current working directory or absolute. If it does not end in a file separator, then EclipseLink appends one that is valid for your operating system. |
|
Create DDL File Name |
Specify the file name of the DDL file that EclipseLink generates that contains SQL statements for creating tables for JPA entities. Specify a file name valid for your operating system. |
|
Drop DDL File Name |
Specify the file name of the DDL file that EclipseLink generates that contains SQL statements for dropping tables for JPA entities. |
|
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
This page enables you to add or remove the vendor-specific <properties>
elements of persistence.xml
.
To add a property, click Add then enter the property Name and Value.
Related references
Java Persistence API (JPA) Extensions Reference for EclipseLink
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm
Using this page, you can manually edit the persistence.xml
file.
See "Managing the persistence.xml file" for additional information.
Related tasks