Creating a data source class

You create a data source by extending the DataSource abstract class and other supporting classes.

A DataSource requires an @IasDataSource annotation. The annotation has several important attributes you can configure:

displayName. Optional. The name of a data source as it is returned from the listModules task of the IAS Server Command-line Utility. If not specified, displayName defaults to the name value.
description. Optional. The description of what the data source can access. The description is returned from the listModules task of the IAS Server Command-line Utility.
id. Optional. If unspecified, the extension defaults to using the fully qualified class name as its id.

The listModules task of the IAS Server Command-line Utility and the listModules()method of the IAS Server API both return the attribute values you specify in the @IasDataSource annotations.

To create a data source extension:

Create a Java project in your development environment of your choice.

If you are creating several extensions in one plugin, you can use the same Java project for each extension.
Add the IAS Extension API libraries to your compile classpath. These include all the libraries available in <install path>\IAS\<version>\lib\ias-extension-api.
Create a subclass of DataSource and specify the PipelineComponentConfiguration subclass that the extension uses. The DataSource requires a zero-argument constructor.
For example:
```
public class CsvDataSource extends DataSource<CsvDataSourceRuntime,CsvDataSourceConfig>{

}
```

Add a @IasDataSource annotation to the DataSource class.

For example:

@IasDataSource(displayName="CSV File", description="Reads comma separated files")
public class CsvDataSource extends DataSource<CsvDataSourceRuntime,CsvDataSourceConfig>{

}

Implement the getConfigurationClass() method to return the appropriate PipelineComponentConfiguration subclass.
For example:
```
public Class<CsvDataSourceConfig> getConfigurationClass() {
		return CsvDataSourceConfig.class;
}
```

Implement the createDataSourceRuntime() method to create an implementation of the DataSourceRuntime class.

For example:

public CsvDataSourceRuntime createDataSourceRuntime(
			CsvDataSourceConfig config, PipelineComponentRuntimeContext context) {
		return new CsvDataSourceRuntime(context, config);
	}

Implement the getRuntimeClass() method to return the runtime class the data source creates.
For example:
```
	public Class<CsvDataSourceRuntime> getRuntimeClass() {
		return CsvDataSourceRuntime.class;
	}
```
Optionally, override the deleteInstance() method. IAS Server calls deleteInstance() when it removes an extension. In this method, you can perform any clean up that is necessary when IAS Server calls deleteInstance() to remove the extension from an acquisition. The default implementation of deleteInstance() is empty.

Example of a data source extension

To see many of the steps above, refer to the sample data source extension in <install path>\IAS\<version>\sample\ias-extensions\src\main\com\endeca\ias\extension\sample\datasource\csv\CsvDataSource.java.