/**********************************************************************
Copyright (c) 2004 Erik Bengtson and others. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Contributors:
2005 Jorg von Frantzius - updates for fetch-depth
2007 Andy Jefferson - rewritten to process all fields detecting persistable objects at runtime
...
**********************************************************************/
package org.datanucleus.store.fieldmanager;
import java.lang.reflect.Array;
import java.util.Collection;
import java.util.Map;
import org.datanucleus.ClassLoaderResolver;
import org.datanucleus.StateManager;
import org.datanucleus.FetchPlan.FetchPlanForClass;
import org.datanucleus.api.ApiAdapter;
import org.datanucleus.exceptions.NucleusUserException;
import org.datanucleus.metadata.AbstractMemberMetaData;
import org.datanucleus.metadata.Relation;
import org.datanucleus.sco.SCO;
import org.datanucleus.sco.SCOUtils;
import org.datanucleus.state.DetachState;
import org.datanucleus.state.FetchPlanState;
/**
* FieldManager to handle the detachment of fields with persistable objects.
*/
public class DetachFieldManager extends AbstractFetchFieldManager
{
/** Whether we should create detached copies, or detach in situ. */
boolean copy = true;
/**
* Constructor for a field manager for detachment.
* @param sm the StateManager of the instance being detached. An instance in Persistent or Transactional state
* @param secondClassMutableFields The second class mutable fields for the class of this object
* @param fpClass Fetch Plan for the class of this instance
* @param state State object to hold any pertinent controls for the detachment process
* @param copy Whether to create detached COPIES or just detach in-situ
*/
public DetachFieldManager(StateManager sm, boolean[] secondClassMutableFields, FetchPlanForClass fpClass, FetchPlanState state,
boolean copy)
{
super(sm, secondClassMutableFields, fpClass, state);
this.copy = copy;
}
/**
* Utility method to process the passed persistable object.
* @param pc The PC object
*/
protected Object processPersistable(Object pc)
{
if (pc == null)
{
return null;
}
ApiAdapter api = sm.getObjectManager().getApiAdapter();
if (!api.isPersistable(pc))
{
return pc;
}
if (!api.isDetached(pc))
{
if (api.isPersistent(pc))
{
// Persistent object that is not yet detached so detach it
if (copy)
{
// Detach a copy and return the copy
return sm.getObjectManager().detachObjectCopy(pc, state);
}
else
{
// Detach the object
sm.getObjectManager().detachObject(pc, state);
}
}
}
return pc;
}
/**
* Method to fetch an object field whether it is collection/map, PC, or whatever for the detachment
* process.
* @param fieldNumber Number of the field
* @return The object
*/
protected Object internalFetchObjectField(int fieldNumber)
{
SingleValueFieldManager sfv = new SingleValueFieldManager();
sm.provideFields(new int[]{fieldNumber}, sfv);
Object value = sfv.fetchObjectField(fieldNumber);
if (value == null)
{
return null;
}
ClassLoaderResolver clr = sm.getObjectManager().getClassLoaderResolver();
ApiAdapter api = sm.getObjectManager().getApiAdapter();
AbstractMemberMetaData mmd =
sm.getClassMetaData().getMetaDataForManagedMemberAtAbsolutePosition(fieldNumber);
int relationType = mmd.getRelationType(clr);
switch (relationType)
{
case Relation.ONE_TO_ONE_BI:
case Relation.ONE_TO_ONE_UNI:
case Relation.MANY_TO_ONE_BI:
if (api.isPersistable(value))
{
// Process PC fields
return processPersistable(value);
}
break;
case Relation.ONE_TO_MANY_BI:
case Relation.ONE_TO_MANY_UNI:
case Relation.MANY_TO_MANY_BI:
if (mmd.hasCollection() || mmd.hasMap())
{
// Process all elements of Collections/Maps that are PC
if (copy)
{
if (!(value instanceof SCO))
{
// Replace with SCO so we can work with it
value = sm.wrapSCOField(fieldNumber, value, false, false, true);
}
if (!(value instanceof SCO) && mmd.isSerialized())
{
// Collection/Map type not supported, but being serialised
if (mmd.hasCollection())
{
if (mmd.getCollection().elementIsPersistent())
{
throw new NucleusUserException("Unable to detach " + mmd.getFullFieldName() +
" since is of an unsupported Collection type with persistent elements");
}
return value;
}
else if (mmd.hasMap())
{
if (mmd.getMap().keyIsPersistent() || mmd.getMap().valueIsPersistent())
{
throw new NucleusUserException("Unable to detach " + mmd.getFullFieldName() +
" since is of an unsupported Map type with persistent keys/values");
}
return value;
}
}
return ((SCO)value).detachCopy(state);
}
else
{
if (!(value instanceof SCO))
{
// Replace with SCO so we can work with it
value = sm.wrapSCOField(fieldNumber, value, false, false, true);
}
SCO sco = (SCO)value;
if (sco instanceof Collection)
{
// Detach all PC elements of the collection
SCOUtils.detachForCollection(sm, ((Collection)sco).toArray(), state);
sco.unsetOwner();
}
else if (sco instanceof Map)
{
// Detach all PC keys/values of the map
SCOUtils.detachForMap(sm, ((Map)sco).entrySet(), state);
sco.unsetOwner();
}
if (SCOUtils.detachAsWrapped(sm))
{
return sco;
}
else
{
return sm.unwrapSCOField(fieldNumber, value, true);
}
}
}
else if (mmd.hasArray())
{
// Process object array
if (!api.isPersistable(mmd.getType().getComponentType()))
{
// Array element type is not persistable so just return
return value;
}
Object[] arrValue = (Object[])value;
Object[] arrDetached = (Object[])Array.newInstance(mmd.getType().getComponentType(), arrValue.length);
for (int j=0;j<arrValue.length;j++)
{
// Detach elements as appropriate
arrDetached[j] = processPersistable(arrValue[j]);
}
return arrDetached;
}
break;
default :
if (secondClassMutableFields[fieldNumber])
{
// Other SCO
if (copy)
{
if (!(value instanceof SCO))
{
// Replace with SCO so we can work with it
value = sm.wrapSCOField(fieldNumber, value, false, false, true);
}
return ((SCO)value).detachCopy(state);
}
if (!(value instanceof SCO))
{
// Replace with SCO so we can work with it
value = sm.wrapSCOField(fieldNumber, value, false, false, true);
}
SCO sco = (SCO)value;
if (SCOUtils.detachAsWrapped(sm))
{
return sco;
}
else
{
return sm.unwrapSCOField(fieldNumber, value, true);
}
}
break;
}
return value;
}
/**
* Method to throw and EndOfFetchPlanGraphException since we're at the end of a branch in the tree.
* @param fieldNumber Number of the field
* @return Object to return
*/
protected Object endOfGraphOperation(int fieldNumber)
{
// check if the object here is PC and is in the detached cache anyway
SingleValueFieldManager sfv = new SingleValueFieldManager();
sm.provideFields(new int[]{fieldNumber}, sfv);
Object value = sfv.fetchObjectField(fieldNumber);
ApiAdapter api = sm.getObjectManager().getApiAdapter();
if (api.isPersistable(value))
{
Object detached = null;
if (copy)
{
detached = ((DetachState)state).getDetachedCopyObject(value);
}
if (detached != null)
{
// While we are at the end of a branch and this would go beyond the depth limits,
// the object here *is* already detached so just return it
return detached;
}
if (!copy && sm.getObjectManager().getApiAdapter().isDetached(value))
{
return value;
}
}
// we reached a leaf of the object graph to detach
throw new EndOfFetchPlanGraphException();
}
}