/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.dialect;

import java.sql.Blob;
import java.sql.Clob;
import java.sql.NClob;

import org.hibernate.engine.spi.SharedSessionContractImplementor;

Strategy for how dialects need LOB values to be merged. 
Author:
Steve Ebersole/**
 * Strategy for how dialects need {@code LOB} values to be merged.
 *
 * @author Steve Ebersole
 */
public interface LobMergeStrategy {
	
Perform merge on Blob values. 
Params:
original – The detached BLOB state
target – The managed BLOB state
session – The session
Returns:
The merged BLOB state/**
	 * Perform merge on {@link Blob} values.
	 *
	 * @param original The detached {@code BLOB} state
	 * @param target The managed {@code BLOB} state
	 * @param session The session
	 *
	 * @return The merged {@code BLOB} state
	 */
	Blob mergeBlob(Blob original, Blob target, SharedSessionContractImplementor session);

	
Perform merge on Clob values. 
Params:
original – The detached CLOB state
target – The managed CLOB state
session – The session
Returns:
The merged CLOB state/**
	 * Perform merge on {@link Clob} values.
	 *
	 * @param original The detached {@code CLOB} state
	 * @param target The managed {@code CLOB} state
	 * @param session The session
	 *
	 * @return The merged {@code CLOB} state
	 */
	Clob mergeClob(Clob original, Clob target, SharedSessionContractImplementor session);

	
Perform merge on NClob values. 
Params:
original – The detached NCLOB state
target – The managed NCLOB state
session – The session
Returns:
The merged NCLOB state/**
	 * Perform merge on {@link NClob} values.
	 *
	 * @param original The detached {@code NCLOB} state
	 * @param target The managed {@code NCLOB} state
	 * @param session The session
	 *
	 * @return The merged {@code NCLOB} state
	 */
	NClob mergeNClob(NClob original, NClob target, SharedSessionContractImplementor session);
}