Oracle Waveset 8.1.1 Deployment Guide

Review the REF Kit

The Sun Resource Extension Facility Kit (REF Kit) is supplied in the /REF directory on the Waveset CD or install image. You can use the sample files and other tools in this REF Kit to jump-start the process of creating your own custom adapter.

The following table describes the contents of the REF Kit.

Table 10–12 REF Kit Components

Component 

Location 

Description  

audit

REF/audit

Sample custom audit publishers. 

exporter

REF/exporter

Warehouse interface code source code that allows you to rebuild the warehouse interface to let Data Exporter export to something other than the warehouse relational database. 

javadoc

REF/javadoc

Generated javadoc that describes the classes you need to write a custom adapter. To view the javadoc, point your browser to:

/waveset/image/REF/javadoc/index.html

lib

REF/lib

Jar files that you need to compile and test a custom adapter. 

src

REF/src

Examples of commonly developed resource adapter source files and skeleton files to use as a basis for adapter development and testing, including:

  • MySQLResourceAdapter.java for Database accounts

  • ExampleTableResourceAdapter.java for Database tables

  • XMLResourceAdapter.java for File-based accounts

  • LDAPResourceAdapter.java for simple methods when developing custom LDAP resource adapters

  • LDAPResourceAdapterBase.java for complex changes when developing custom LDAP resource adapters

  • AIXResourceAdapter.java for developing UNIX accounts

  • SkeletonStandardResourceAdapter.java for standard resources

  • SkeletonStandardAndActiveSyncResourceAdapter.java for standard and Active Sync-enabled resources

  • SkeletonActiveSyncResourceAdapter.java for Active Sync-only resources

  • test.SkeletonResourceTest.java to create unit tests for a custom adapter

test

REF/test

Sample resource adapter test source files that you can use as a basis for a custom adapter. 

thirdpartysource

REF/thirdpartysource

 

transactionsigner

REF/transactionsigner

Sample implementation of a transactionsigner PKCS11KeyProvider.

BeforeYouBegin.README

REF

Outlines information you must collect before you customize an adapter. 

build.xml

REF

Sample Ant Build script for building, testing, and distributing a project.

Design-for-Resource-Adapters.htm

REF

Document that describes the basic architecture and design of a resource adapter. 

README 

REF

Document describing the Waveset REF Kit. 

Waveset.properties

REF/config

Copy of the properties file you need to test a custom adapter.