code: public void setValues(
                      final Collection<?> values
                      )
      {
          if (values != _values) {
              clear();
              if (values == null  ||  values.size() == 0) {
                  return;
              }
  
              for (Object  value : values) {
                  addValue( value );
              }
          }
      }
docs: Sets the specified values as the matching value list.
  First, the previous list are cleared and all of
  the specified values are appended to the list.
  
  @param   values
  a collection whose elements are appended
  to the matching value list.