javax.resource.cci
Interface RecordFactory


public interface RecordFactory

The RecordFactory interface is used for creating MappedRecord and IndexedRecord instances. Note that the RecordFactory is only used for creation of generic record instances. A CCI implementation provides an implementation class for the RecordFactory interface.

Since:
0.8
Author:
Rahul Sharma
See Also:
IndexedRecord, MappedRecord

Method Summary
 IndexedRecord createIndexedRecord(java.lang.String recordName)
          Creates a IndexedRecord.
 MappedRecord createMappedRecord(java.lang.String recordName)
          Creates a MappedRecord.
 

Method Detail

createMappedRecord

MappedRecord createMappedRecord(java.lang.String recordName)
                                throws ResourceException
Creates a MappedRecord. The method takes the name of the record that is to be created by the RecordFactory. The name of the record acts as a pointer to the meta information (stored in the metadata repository) for a specific record type.

Parameters:
recordName - Name of the Record
Returns:
MappedRecord
Throws:
ResourceException - Failed to create a MappedRecord. Example error cases are:
  • Invalid specification of record name
  • Resource adapter internal error
  • Failed to access metadata repository
NotSupportedException - Operation not supported

createIndexedRecord

IndexedRecord createIndexedRecord(java.lang.String recordName)
                                  throws ResourceException
Creates a IndexedRecord. The method takes the name of the record that is to be created by the RecordFactory. The name of the record acts as a pointer to the meta information (stored in the metadata repository) for a specific record type.

Parameters:
recordName - Name of the Record
Returns:
IndexedRecord
Throws:
ResourceException - Failed to create an IndexedRecord. Example error cases are:
  • Invalid specification of record name
  • Resource adapter internal error
  • Failed to access metadata repository
NotSupportedException - Operation not supported


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41