/**
 * Enum that defines the type of operations that can be tracked for the lineage
 */
public enum OperationType {
	CREATE,  // New field is created
	READ, // Field is read
    UPDATE, // Field value is updated
    DELETE, // Field is deleted from the dataset
    RENAME // Field is renamed into some other field
}
 
public class FieldOperation {
	private final Field field; // Represents the field with associated schema
	private final OperationType type; // Represents operation to be performed on the field
	@Nullable
	private final Field renamedField; // If the operation type is RENAME which means the program is renaming the field 
}

/**
 * Get an instance of the specified Dataset.
 *
 * @param name The name of the Dataset
 * @param fieldOperations The field operations that are expected to be performed on the dataset
 * @param <T> The type of the Dataset
 * @return An instance of the specified Dataset, never null.
 * @throws DatasetInstantiationException If the Dataset cannot be instantiated: its class
 *         cannot be loaded; the default constructor throws an exception; or the Dataset
 *         cannot be opened (for example, one of the underlying tables in the DataFabric
 *         cannot be accessed).
 */
<T extends Dataset> T getDataset(String name, Set<FieldOperation> fieldOperations) throws DatasetInstantiationException;

/**
 * Get an instance of the specified Dataset.
 *
 * @param namespace The namespace of the Dataset
 * @param name The name of the Dataset
 * @param fieldOperations The field operations that are expected to be performed on the dataset
 * @param <T> The type of the Dataset
 * @return An instance of the specified Dataset, never null.
 * @throws DatasetInstantiationException If the Dataset cannot be instantiated: its class
 *         cannot be loaded; the default constructor throws an exception; or the Dataset
 *         cannot be opened (for example, one of the underlying tables in the DataFabric
 *         cannot be accessed).
 */
<T extends Dataset> T getDataset(String namespace, String name, Set<FieldOperation> fieldOperations) throws DatasetInstantiationException;

/**
 * Get an instance of the specified Dataset.
 *
 * @param name The name of the Dataset
 * @param arguments the arguments for this dataset instance
 * @param fieldOperations The field operations that are expected to be performed on the dataset
 * @param <T> The type of the Dataset
 * @return An instance of the specified Dataset, never null.
 * @throws DatasetInstantiationException If the Dataset cannot be instantiated: its class
 *         cannot be loaded; the default constructor throws an exception; or the Dataset
 *         cannot be opened (for example, one of the underlying tables in the DataFabric
 *         cannot be accessed).
 */
<T extends Dataset> T getDataset(String name, Map<String, String> arguments, Set<FieldOperation> fieldOperations) throws DatasetInstantiationException;

/**
 * Get an instance of the specified Dataset.
 *
 * @param namespace The namespace of Dataset
 * @param name The name of the Dataset
 * @param arguments the arguments for this dataset instance
 * @param fieldOperations The field operations that are expected to be performed on the dataset
 * @param <T> The type of the Dataset
 * @return An instance of the specified Dataset, never null.
 * @throws DatasetInstantiationException If the Dataset cannot be instantiated: its class
 *         cannot be loaded; the default constructor throws an exception; or the Dataset
 *         cannot be opened (for example, one of the underlying tables in the DataFabric
 *         cannot be accessed).
 */
<T extends Dataset> T getDataset(String namespace, String name, Map<String, String> arguments, Set<FieldOperation> fieldOperations)
  throws DatasetInstantiationException;

/**
 * This interface provides methods that will allow programs to record the lineage at field level
 */
public interface LineageRecorder {
    /**
 	 * Record the lineage for the given dataset.
 	 *
 	 * @param datasetName The name of the Dataset
 	 * @param operations The set of field level operations that will be performed on the dataset
 	*/
    void recordLineage(String datasetName, Set<FieldOperation> operations);
 
    /**
 	 * Record the lineage for the given dataset in a given namespace.
 	 *
 	 * @param namespace The name of the namespace
 	 * @param datasetName The name of the Dataset
 	 * @param operations The set of field level operations that will be performed on the dataset in the given namespace
 	*/
 	void recordLineage(String namespace, String datasetName, Set<FieldOperation> operations);
}