Oracle Configurator Extensions and Interface Object Developer’s Guide


Title and Copyright Information

Send Us Your Comments


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
Product Support

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