/*
 * Copyright (c) 2013, 2019 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0,
 * or the Eclipse Distribution License v. 1.0 which is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause
 */

// Contributors:
//     Blaise Doughan - 2.6 - initial implementation
package org.eclipse.persistence.core.mappings.transformers;

import java.io.Serializable;

import org.eclipse.persistence.core.sessions.CoreSession;

/**
 * This interface is used by the Transformation Mapping to build the value for a
 * specific field. The user must provide implementations of this interface to the
 * Transformation Mapping.
 */
public interface CoreFieldTransformer<SESSION extends CoreSession> extends Serializable {

    /**
     * Method name should be same as the value of this field. This field is used to find method name in reflection call.
     */
    String BUILD_FIELD_VALUE_METHOD = "buildFieldValue";

    /**
     * @param instance - an instance of the domain class which contains the attribute
     * @param session - the current session
     * @param fieldName - the name of the field being transformed. Used if the user wants to use this transformer for multiple fields.
     * @return - The value to be written for the field associated with this transformer
     */
    Object buildFieldValue(Object instance, String fieldName, SESSION session);

}