com.thortech.xl.gc.spi

Interface ValidationProvider

public interface ValidationProvider

This interface should be implemented by a layer that incorporates data validation functionalities to be used by a connector created through the generic technology connector. An example of data validation is Maximum Length. The input data set, having data for an attribute "employeeID" could be validated using MaxLength implementation so that any data record that has the value "employeeID" and a size greater than a pre-defined length will always get rejected.

In the generic technology connector framework, the provisioning operation does not have any step for data validation to be executed by implementing this interface. The framework invokes the validation implementations only during reconciliation. It is executed after it obtains the Oracle Identity Manager-compliant output of appropriate ReconTransportProvider and ReconFormatProvider. Only validated data records are passed ahead for transformation. Examples of the implementation for this layer would be MaxLength, MinLength and IsInteger.

All the methods of this interface throw ProviderException. The implementations of this interface should utilize this fact to wrap all possible exceptions ultimately in an instance of ProviderException.

See Also:

ProviderException

Method Summary

Modifier and Type	Method and Description
boolean	validate(java.lang.String input, java.util.Hashtable params, java.util.Hashtable utils) This method validates input data based on the logic defined by the relevant validation provider.

Method Detail

validate

boolean validate(java.lang.String input,
                 java.util.Hashtable params,
                 java.util.Hashtable utils)
          throws ProviderException

This method validates input data based on the logic defined by the relevant validation provider.

Parameters:

input - The input candidate to be validated

params - contains the input field-value pairs which are arguments required by this validation

utils - contains the reference to factory object for obtaining an Oracle Identity Manager API Instance. This might be useful for those validation implementations that want to retrieve an Oracle Identity Manager entity value(s) for executing some business logic. For example, Encoded and Decoded value pairs of an Oracle Identity Manager Lookup Definition.

Relevant Sample code:

Iterator itr = utils.keySet().iterator();

String key = (String) itr.next();

TransformationSource source=(TransformationSource)utils.get(key);

tcLookupOperationsIntf lookupIntf = (tcLookupOperationsIntf)source.getUtility("Thor.API.Operations.tcLookupOperationsIntf");

Returns:

Result of validation.

Throws:

ProviderException

See Also:

GCSource, TransformationSource