Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.uima.util
Class CasCopier

    java.lang.Object
      org.apache.uima.util.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
`CasCopier(CAS aSrcCas, CAS aDestCas)` Creates a new CasCopier that can be used to copy FeatureStructures from one CAS to another.

Method Summary
`boolean` | `alreadyCopied(FeatureStructure aFS)` Returns whether the given FS has already been copied using this CasCopier.
`static void` | `copyCas(CAS aSrcCas, CAS aDestCas, boolean aCopySofa)` Does a complete deep copy of one CAS into another CAS.
`void` | `copyCasView(CAS aSrcCasView, boolean aCopySofa)` Does a deep copy of the contents of one CAS View into another CAS.
`FeatureStructure` | `copyFs(FeatureStructure aFS)` Copies an FS from the source CAS to the destination CAS.

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

Constructor Detail

### CasCopier

    public CasCopier(CAS aSrcCas,
                     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(CAS aSrcCas,
                               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(CAS aSrcCasView,
                            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 FeatureStructure copyFs(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(FeatureStructure aFS)

  Returns whether the given FS has already been copied using this CasCopier.

  Parameters:
    `aFS` -
  Returns:

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2008 The Apache Software Foundation. All Rights Reserved.