inheritance.outer-join

Use eclipselink.inheritance.outer-join to configure the query to use an outer-join for all subclasses.

Values

Table 4-12 describes this query hint's values.

Table 4-12 Valid Values for inheritance.outer-join

Value Description

true

Use outer-join.

false

(Default) Do not use outer-join; execute a separate query for each subclass.


Usage

This query hint can be used queries to root or branch inherited classes.

You can also configure this behavior by using a DescriptorCustomizer (see "descriptor.customizer").

Note:

This is required for correct ordering, firstResult, maxResult, and cursors.

Examples

Example 4-25 Using inheritance.outer-join in a JPA Query

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.QueryHints;
 query.setHint("eclipselink.INHERITANCE_OUTER_JOIN", "TRUE");

Example 4-26 Using inheritance.outer-join in a @QueryHint Annotation

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.QueryHints;
 @QueryHint(name=QueryHints.INHERITANCE_OUTER_JOIN, value="TRUE");

See Also

For more information, see:

  • "Inheritance" in Understanding Oracle TopLink

  • "Enhancing Performance" in Solutions Guide for Oracle TopLink