Overview | Package | Class | Tree | Index | Help

Oracle® Coherence Java API Reference
v3.5.3
E15583-01
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.tangosol.util.extractor
Class CompositeUpdater

    java.lang.Object
      com.tangosol.util.Base
          com.tangosol.util.extractor.CompositeUpdater

All Implemented Interfaces:
  ExternalizableLite, PortableObject, ValueUpdater, java.io.Serializable

    public class CompositeUpdater

extends Base
implements ValueUpdater, ExternalizableLite, PortableObject

A ValueManipulator implementation based on an extractor-updater pair.

Author:
  gg 2005.10.31
See Also:
  `ChainedExtractor`

Field Summary
`protected ValueExtractor` | `m_extractor` The ValueExtractor part.
`protected ValueUpdater` | `m_updater` The ValueUpdater part.

Constructor Summary
`CompositeUpdater()` Default constructor (necessary for the ExternalizableLite interface).
`CompositeUpdater(java.lang.String sName)` Construct a CompositeUpdater for a specified method name sequence.
`CompositeUpdater(ValueExtractor extractor, ValueUpdater updater)` Construct a CompositeUpdater based on the specified extractor and updater.

Method Summary
`ValueExtractor` | `getExtractor()` Retreive the ValueExtractor part.
`ValueUpdater` | `getUpdater()` Retreive the ValueUpdator part.
`void` | `readExternal(java.io.DataInput in)` Restore the contents of this object by loading the object's state from the passed DataInput object.
`void` | `readExternal(PofReader in)` Restore the contents of a user type instance by reading its state using the specified PofReader object.
`java.lang.String` | `toString()` Return a human-readable description for this CompositeUpdater.
`void` | `update(java.lang.Object oTarget, java.lang.Object oValue)` Update the state of the passed target object using the passed value.
`void` | `writeExternal(java.io.DataOutput out)` Save the contents of this object by storing the object's state into the passed DataOutput object.
`void` | `writeExternal(PofWriter out)` Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

Field Detail

### m_extractor

    protected ValueExtractor m_extractor

  The ValueExtractor part.

### m_updater

    protected ValueUpdater m_updater

  The ValueUpdater part.

Constructor Detail

### CompositeUpdater

    public CompositeUpdater()

  Default constructor (necessary for the ExternalizableLite interface).

### CompositeUpdater

    public CompositeUpdater(ValueExtractor extractor,
                            ValueUpdater updater)

  Construct a CompositeUpdater based on the specified extractor and updater.

  Note: the extractor and updater here are not symmetrical in nature: the extractor is used to "drill-down" to the target object, while the updater will operate on that extracted object.

  Parameters:
    `extractor` - the ValueExtractor
    `updater` - the ValueUpdater

### CompositeUpdater

    public CompositeUpdater(java.lang.String sName)

  Construct a CompositeUpdater for a specified method name sequence.

  For example: "getAddress.setZip" method name will indicate that the "getAddress()" method should be used to extract an Address object, which will then be used by the "setZip(String)" call.

  Parameters:
    `sName` - a dot-delimited sequence of N method names which results in a CompositeUpdater that is based on an chain of (N-1) `ReflectionExtractor` objects and a single `ReflectionUpdater`.

Method Detail

### update

    public void update(java.lang.Object oTarget,
                       java.lang.Object oValue)

  Update the state of the passed target object using the passed value. For intrinsic types, the specified value is expected to be a standard wrapper type in the same manner that reflection works; for example, an `int` value would be passed as a `java.lang.Integer`.

  Specified by:
    `update` in interface `ValueUpdater`
  Parameters:
    `oTarget` - the Object to update the state of
    `oValue` - the new value to update the state with

### getExtractor

    public ValueExtractor getExtractor()

  Retreive the ValueExtractor part.

  Returns:
    the ValueExtractor

### getUpdater

    public ValueUpdater getUpdater()

  Retreive the ValueUpdator part.

  Returns:
    the ValueUpdater

### toString

    public java.lang.String toString()

  Return a human-readable description for this CompositeUpdater.

  Returns:
    a String description of the CompositeUpdater

### readExternal

    public void readExternal(java.io.DataInput in)
                      throws java.io.IOException

  Restore the contents of this object by loading the object's state from the passed DataInput object.

  Specified by:
    `readExternal` in interface `ExternalizableLite`
  Parameters:
    `in` - the DataInput stream to read data from in order to restore the state of this object
  Throws:
    `java.io.IOException` - if an I/O exception occurs
    `java.io.NotActiveException` - if the object is not in its initial state, and therefore cannot be deserialized into

### writeExternal

    public void writeExternal(java.io.DataOutput out)
                       throws java.io.IOException

  Save the contents of this object by storing the object's state into the passed DataOutput object.

  Specified by:
    `writeExternal` in interface `ExternalizableLite`
  Parameters:
    `out` - the DataOutput stream to write the state of this object to
  Throws:
    `java.io.IOException` - if an I/O exception occurs

### readExternal

    public void readExternal(PofReader in)
                      throws java.io.IOException

  Restore the contents of a user type instance by reading its state using the specified PofReader object.

  Specified by:
    `readExternal` in interface `PortableObject`
  Parameters:
    `in` - the PofReader from which to read the object's state
  Throws:
    `java.io.IOException` - if an I/O error occurs

### writeExternal

    public void writeExternal(PofWriter out)
                       throws java.io.IOException

  Save the contents of a POF user type instance by writing its state using the specified PofWriter object.

  Specified by:
    `writeExternal` in interface `PortableObject`
  Parameters:
    `out` - the PofWriter to which to write the object's state
  Throws:
    `java.io.IOException` - if an I/O error occurs

Overview | Package | Class | Tree | Index | Help

Oracle® Coherence Java API Reference
v3.5.3
E15583-01
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000, 2010, Oracle. All rights reserved.