Oracle Configurator Extensions and Interface Object Developer’s Guide

Contents

Title and Copyright Information

Send Us Your Comments

Preface

Configurator Extensions

This Part describes the essential steps in creating Java classes for Configurator Extensions. It also provides examples of some typical ways to use Configurator Extensions.

Configurator Extension Basics

Introduction to Configurator Extensions

What are Configurator Extensions?

Prerequisite Skills for Developing Configurator Extensions

Important Facts About Configurator Extensions

Requirements and Restrictions for Configurator Extensions

      Requirements for Configurator Extensions

      Restrictions for Configurator Extensions

Configurator Extensions and the CIO

Installation Requirements for Configurator Extensions

      Installation Requirements for Developing Configurator Extensions

      Installation Requirements for Compiling Configurator Extensions

      Installation Requirements for Testing Configurator Extensions

Conventions

Product Support

      Troubleshooting

Building Configurator Extensions

Overview of Building Configurator Extensions

      Implementing Behavior with Java Classes

      Incorporating Behavior into Configuration Models

Developing Java Classes and Archives

Example of Configurator Extension Development

      Example of Configurator Extension Coding

      Example of Configurator Extension Modeling

Suggested Development Practices

      Observing Project Requirements

      Avoiding Common Errors

      Observing Thread Safety

      Handling Exceptions Properly

      Avoiding Circularity and Recursion

      Taking Advantage of Argument Binding

      Sharing Class Instances

      Disabling Configurator Extensions

      Testing for a Null User Interface

      Using Logging to Examine Problems

      Checking for Deleted or Discontinued Nodes

      Managing JDBC Connections

      Accessing More Node and Text IDs

Uses for Configurator Extensions

Types of Configuration Events

Generating Custom Output

Filtering for Connectivity

      Defining a Connection Filter Configurator Extension

      Behavior of Connection Filter Configurator Extensions

      Example of a Connection Filter Configurator Extension

Requiring Text Input Dynamically

The Configuration Interface Object (CIO)

This Part describes the API called the Configuration Interface Object (CIO) and how to use it to interact with the runtime Oracle Configurator. The CIO is used both by Configurator Extensions and by custom applications.

CIO Basics

Background to the CIO

      What is the CIO?

      The CIO and Configurator Extensions

The CIO’s Runtime Node Interfaces

Initializing the CIO

Working with Configurations

Overview of Configurations

Creating Configurations

Removing Runtime Configurations

Saving Configurations

Monitoring Changes to Configurations

      How the CIO Monitors Changes to Configurations

      How You Can Monitor Changes to Configurations

Restoring Configurations

Restarting Configurations

Automatic Behavior for Configurations

Dispatching Command Events

Access to Configuration Parameters

Sharing a Configuration Session

      Redirecting to a Framework Page

Working with Model Entities

Accessing Runtime Nodes

Opportunities for Modifying the Configuration

Accessing Components

      Adding and Deleting Instantiable Components

      Renaming Instances of Components

Accessing Features

Getting and Setting Logic States

Getting and Setting Numeric Values

      Working with Decimal Quantities

Accessing Properties

      User String Properties

Access to Options

Introspection through IRuntimeNode

Using Logic Transactions

Using Logic Transactions

Validation, Contradictions, and Exceptions

Introduction to Validation, Contradictions, and Exceptions

Validating Configurations

Handling Logical Contradictions

      Generating Error Messages from Contradictions

      Overriding Contradictions

Handling Exceptions

      Handling Types of Exceptions

      Raising Fatal Exceptions

      Presenting Messages for Exceptions

      Compatibility of Certain Deprecated Exceptions

Using Requests

About Requests

Getting Information about Requests

User Requests

Nonoverridable Requests

      Usage Notes on Nonoverridable Requests

      Limitations on Nonoverridable Requests

Failed Requests

Configuration Session Change Tracking

Introduction to Configuration Session Change Tracking

How Change Tracking Works

      Relationship of the Classes

      Role of the DeltaManager

      Role of DeltaRegions

      Role of DeltaValidators

      Role of the IValidatorChange Interface

Starting a Session

      Creating a Configuration Object

      Associating a DeltaManager

      Specifying DeltaValidators

      Registering DeltaRegions

Tracking Session Changes

Updating a Region

Handling Screen Changes

Creating a Custom DeltaValidator

Unified Code Example for Change Tracking

Logging Through the CIO

Overview of Logging

Enabling Logging Scope

Creating Entries in the Log

      Testing Whether Logging Is Enabled

      Writing Log Entries

Recommended Practices for Logging

Example of Logging

Logging for a Custom Application

Reference Documentation for the CIO

About This Appendix

Code Examples

About This Appendix

Generating Output Related to Model Structure

Using Requests

      Setting Nonoverridable Requests

      Getting a List of Failed Requests

Sharing a Configuration Session in a Child Window

Tracking Configuration Session Changes

Java Parameter Types for Configurator Extensions

About This Appendix

Common Glossary for Oracle Configurator

Index