72 Creating an EIS Project

This chapter describes the various components that you must configure in order to create an EIS project.

This chapter includes the following sections:

For information on how to create more than one type of TopLink projects, see Chapter 116, "Creating a Project".

72.1 Introduction to EIS Project Creation

You can create a project using Oracle JDeveloper TopLink Editor, TopLink Workbench, or Java code.

Oracle recommends using either Oracle JDeveloper or TopLink Workbench to create projects and generate deployment XML, or Java source versions of the project for use at run time. For more information on how to create a project using TopLink Workbench, see Section 116.1.2, "How to Create a Project Using TopLink Workbench". For more information on how to create a project using Oracle JDeveloper, see Section 116.1.1, "How to Create a Project Using Oracle JDeveloper". For information on how to create a project using Java, see Section 116.1.3, "How to Create a Project Using Java".

For more information, see Chapter 71, "Introduction to EIS Projects".

For an EIS project that uses a record type other than XML, you must use Java code. For more information, see the following:

72.2 Creating an EIS Project with XML Records

TopLink Workbench provides complete support for creating EIS projects that map Java objects to EIS XML records.

Using TopLink Workbench, you can create an EIS project for transactional persistence of Java objects to a non-relational data source accessed using a JCA adapter and EIS XML records.

The TopLink runtime performs XML data conversions based on one or more XML schemas. In an EIS project, TopLink Workbench does not directly reference schemas in the deployment XML, but instead exports mappings configured in accordance to specific schemas.

EIS queries use XMLInteraction. For more information, see Section 109.8, "Using EIS Interactions".

72.2.1 How to Create an EIS Project with XML Records Using Oracle JDeveloper

Refer to Section 116.1.1, "How to Create a Project Using Oracle JDeveloper" for this information.

72.2.2 How to Create an EIS Project with XML Records Using TopLink Workbench

Refer to Section 116.1.2, "How to Create a Project Using TopLink Workbench" for this information.

72.3 Creating an EIS Project with Indexed or Mapped Records

TopLink Workbench does not currently support non-XML EIS projects. You must create such an EIS project in Java.

Using Java, you can create an EIS project for transactional persistence of Java objects to a nonrelational data source accessed using a JCA adapter and any supported EIS record type including indexed, mapped, or XML records.

If you use XML records, the TopLink runtime performs XML data conversion based on one or more XML schemas. When you create an EIS project in Java, you configure mappings with respect to these schemas, but the TopLink runtime does not directly reference them.

You can base queries on any supported EIS interaction: IndexedInteraction, MappedInteraction (including QueryStringInteraction), or XMLInteraction (including XQueryInteraction). For more information, see Section 109.8, "Using EIS Interactions".

72.3.1 How to Create an EIS Project with Indexed or Mapped Records Using Java

Refer to Section 116.1.3, "How to Create a Project Using Java" for this information.