com.ibm.portal.resolver.data
Interface DataSourceFactoryEx

All Superinterfaces:

DataSourceFactory

public interface DataSourceFactoryEx
extends DataSourceFactory

Data source factory that allows to instantiate DataSource objects. The data sources need to implement one of the strongly typed interfaces ByteDataSource, CharDataSource, XmlDataSource or com.ibm.portal.resolver.data.MultipartDataSource. Clients of the DataSourceFactoryEx will determine the type of the returned data source via introspection.

A data source factory is registered in the plugin.xml of the providing extension as a serviceHandler

.

 <extension
 point="com.ibm.content.operations.registry.locationServiceHandler">
 <serviceHandler
 class="YOUR_IMPLEMENTATION_CLASS"
 locationTypeId="LOCATION_TYPE_ID"
 id="com.ibm.portal.resolver.data.DataSourceFactoryEx" />
 </extension>
 

Since:

6.1.0

Note:

This interface is designed to be implemented by clients.

Method Summary

DataSource

newSource(java.net.URI uri, java.lang.String mode, java.util.Map<java.lang.String,java.lang.String[]> params, Context ctx)

Method Detail

newSource

DataSource newSource(java.net.URI uri,
                     java.lang.String mode,
                     java.util.Map<java.lang.String,java.lang.String[]> params,
                     Context ctx)
                     throws java.io.IOException

Parameters:

uri - URI of the addressed resource

mode - mode constant

params - parameters map (String -> String[]). This map is potentially unmodifiable

ctx - Content Operations Registry (COR) context

Returns:

an implementation of a DataSource. May be null in which case the implementation indicates that the URI will not be processed.

Throws:

java.io.IOException - - if the data soure cannot be created