Deprecate IBaseDataObjectHelper.clone() that allows partial clones.

[jdcove2]

This PR deprecates the IBaseDataObjectHelper.clone() method that allows for partial clones. Partial clones were implemented to allow cloning that matched the now deprecated BaseDataObject.clone() method. A search of the code bases did not show any instance where IBaseDataObjectHelper.clone() was called for a partial clone except for in the IBaseDataObjectHelperTest class. Therefore, only full clones seem to be needed and partial clones should be removed.

[drivenflywheel]

I'm not a fan having the new overload reference the very method we're deprecating. Maybe we should refactor the existing one by extracting two supporting methods that both overloads can use. Something like the following signatures:

private static copyBasicFields(final IBaseDataObject src, final IBaseDataObject dest) {
    // body would be current lines 66-87 
}
private static copyNonBasicFields(final IBaseDataObject src, final IBaseDataObject dest) {
    // body would be current lines 90-106
}

With that change, this overload would strip down to the following:

 public static IBaseDataObject clone(final IBaseDataObject src) {
    Validate.notNull(src, "Required: src not null");
    IBaseDataObject dst = new InternalIdBaseDataObject(src.getInternalId());
    copyBasicFields(src, dst);
    copyNonBasicFields(src, dst);
    retrun dst;
}

The original now-deprecated overload would become this:

 public static IBaseDataObject clone(final IBaseDataObject src, final boolean fullClone) {
    Validate.notNull(src, "Required: src not null");
    IBaseDataObject dst = fullClone ? new InternalIdBaseDataObject(src.getInternalId()) : DataObjectFactory.getInstance();
    copyBasicFields(src, dst);
    if (fullClone) {
        copyNonBasicFields(src, dst);
    }
    retrun dst;
}

After the deprecated overload is removed, we can collapse those private methods into the remaining clone method

[drivenflywheel]

Suggested change

	* @deprecated
	* @deprecated prefer {@link #clone(IBaseDataObject)}

[drivenflywheel]

Suggested change

	@Deprecated
	@Deprecated(forRemoval = true)