CasCopier (DKPro Core - Master Aggregator 1.7.0 API)

java.lang.Object
- de.tudarmstadt.ukp.dkpro.core.castransformation.CasCopier

```
public class CasCopier
extends Object
```
Utility class for doing deep copies of FeatureStructures from one CAS to another. To handle cases where the source CAS has multiple references to the same FS, you can create one instance of CasCopier and use it to copy multiple FeatureStructures. The CasCopier will remember previously copied FeatureStructures, so if you later copy another FS that has a reference to a previously copied FS, it will not duplicate the multiply-referenced FS.

Constructor Summary

Constructors
Constructor and Description
`CasCopier(org.apache.uima.cas.CAS aSrcCas, org.apache.uima.cas.CAS aDestCas)` Creates a new CasCopier that can be used to copy FeatureStructures from one CAS to another.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`alreadyCopied(org.apache.uima.cas.FeatureStructure aFS)` Returns whether the given FS has already been copied using this CasCopier.
`static void`	`copyCas(org.apache.uima.cas.CAS aSrcCas, org.apache.uima.cas.CAS aDestCas, boolean aCopySofa)` Does a complete deep copy of one CAS into another CAS.
`void`	`copyCasView(org.apache.uima.cas.CAS aSrcCasView, String targetName, boolean aCopySofa)` Does a deep copy of the contents of one CAS View into another CAS.
`org.apache.uima.cas.FeatureStructure`	`copyFs(org.apache.uima.cas.FeatureStructure aFS)` Copies an FS from the source CAS to the destination CAS.
`boolean`	`isCopied(org.apache.uima.cas.FeatureStructure fs)` Check if the given FS was included in the copy.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - CasCopier
```
public CasCopier(org.apache.uima.cas.CAS aSrcCas,
         org.apache.uima.cas.CAS aDestCas)
```
    Creates a new CasCopier that can be used to copy FeatureStructures from one CAS to another. Note that if you are merging data from multiple CASes, you must create a new CasCopier for each source CAS.
    
    Parameters:
    aSrcCas - the CAS to copy from.
    aDestCas - the CAS to copy into.
- Method Detail
  - copyCas
```
public static void copyCas(org.apache.uima.cas.CAS aSrcCas,
           org.apache.uima.cas.CAS aDestCas,
           boolean aCopySofa)
```
    Does a complete deep copy of one CAS into another CAS. The contents of each view in the source CAS will be copied to the same-named view in the destination CAS. If the view does not already exist it will be created. All FeatureStructures that are indexed in a view in the source CAS will become indexed in the same-named view in the destination CAS.
    
    Parameters:
    aSrcCas - the CAS to copy from
    aDestCas - the CAS to copy to
    aCopySofa - if true, the sofa data and mimeType of each view will be copied. If false they will not.
  - copyCasView
```
public void copyCasView(org.apache.uima.cas.CAS aSrcCasView,
               String targetName,
               boolean aCopySofa)
```
    Does a deep copy of the contents of one CAS View into another CAS. If a view with the same name as aSrcCasView exists in the destination CAS, then it will be the target of the copy. Otherwise, a new view will be created with that name and will become the target of the copy. All FeatureStructures that are indexed in the source CAS view will become indexed in the target view.
    
    Parameters:
    aSrcCasView - the CAS to copy from
    aCopySofa - if true, the sofa data and mimeType will be copied. If false they will not.
  - copyFs
```
public org.apache.uima.cas.FeatureStructure copyFs(org.apache.uima.cas.FeatureStructure aFS)
```
    Copies an FS from the source CAS to the destination CAS. Also copies any referenced FS, except that previously copied FS will not be copied again.
    
    Parameters:
    aFS - the FS to copy. Must be contained within the source CAS.
    
    Returns:
    the copy of aFS in the target CAS.
  - alreadyCopied
```
public boolean alreadyCopied(org.apache.uima.cas.FeatureStructure aFS)
```
    Returns whether the given FS has already been copied using this CasCopier.
  - isCopied
```
public boolean isCopied(org.apache.uima.cas.FeatureStructure fs)
```
    Check if the given FS was included in the copy.

Class CasCopier

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CasCopier

Method Detail

copyCas

copyCasView

copyFs

alreadyCopied

isCopied