Настройка TreeViewer с привязкой EMF-данных

• TreeFactory : отвечает за создание списков IObservableList для наблюдения дочерних элементов триода
• TreeStructureAdvisor : отвечает за предоставление информации о том, как получить доступ к родительскому элементу модели элемента, и помогает принять решение, если элемент имеет дочерние элементы.

Глядя на рисунок выше, мы видим, что наша структура является немного виртуальной, когда мы сравниваем ее с экземпляром домена, где мы увидим только отношение проект-подпроекты на первый взгляд.

Однако наш просмотрщик отображает различные многозначные объекты как дочерние элементы в дереве:

• подпроекты, элементы которых имеют тип Project
• коммиттерсы, элементы которых имеют тип CommitterShip

Отображение различных типов объектов не было поддержано в 3.4 и является новой функцией в новой реализации привязки данных, а также возможностью объединить 2 многозначных объекта в один наблюдаемый список, что лично для меня является одной из самых крутых функций в свойствах -API.

  private static class TreeFactoryImpl
    implements IObservableFactory
  {
    private IEMFListProperty multi = EMFProperties.multiList(
      ProjectPackage.Literals.PROJECT__SUBPROJECTS,
      ProjectPackage.Literals.PROJECT__COMMITTERS);

    public IObservable createObservable(final Object target)
    {
      if (target instanceof IObservableList)
      {
        return (IObservable)target;
      }
      else if (target instanceof Project)
      {
        return multi.observe(target);
      }

      return null;
    }
  }

  private static class TreeStructureAdvisorImpl
    extends TreeStructureAdvisor
  {
    @Override
    public Object getParent(Object element)
    {
      if (element instanceof Project)
      {
        return ((Project)element).getParent();
      }

      return null;
    }

    @Override
    public Boolean hasChildren(Object element)
    {
      if (element instanceof Project
        && (
          ((Project)element).getCommitters().size() > 0
          || ((Project)element).getSubprojects().size() > 0
        )
      )
      {
        return Boolean.TRUE;
      }
      return super.hasChildren(element);
    }
  }

и используется как это

private TreeViewer init(Composite parent,
  Foundation foundation)
{
  TreeViewer viewer = new TreeViewer(parent);
  ObservableListTreeContentProvider cp =
    new ObservableListTreeContentProvider(
      new TreeFactoryImpl(),
      new TreeStructureAdvisorImpl()
  );
  viewer.setContentProvider(cp);

  // rest of viewer setup
}

Создание CellLabelProvider

Чтобы получить такое красивое дерево, мы не можем использовать простой CellLabelProvider (например, ColumnLabelProvider — его простая реализация), но нам нужно одно с большим количеством функций. Другой реализацией CellLabelProvider является StyledCellLabelProvider, который использует владелец-рисование для рисования StyledText-Strings в дереве.

JFace-Databinding не предоставляет реализацию StyledCellLabelProvider из коробки, поэтому мне пришлось написать свою собственную, но это не так уж сложно. Единственное, что нужно сделать, это подключить слушатель к IObservableMap (s), чтобы наблюдать атрибуты всех элементов дерева и обновлять средство просмотра, если один из них изменяется.

private class TreeLabelProviderImpl
  extends StyledCellLabelProvider
{
  private IMapChangeListener mapChangeListener =
    new IMapChangeListener()
    {
      public void handleMapChange(MapChangeEvent event)
      {
        Set<?> affectedElements =
          event.diff.getChangedKeys();
        if (!affectedElements.isEmpty())
        {
          LabelProviderChangedEvent newEvent =
            new LabelProviderChangedEvent(
              TreeLabelProviderImpl.this,
              affectedElements.toArray()
          );
          fireLabelProviderChanged(newEvent);
        }
      }
    };

  public TreeLabelProviderImpl(
    IObservableMap... attributeMaps)
  {
    for (int i = 0; i < attributeMaps.length; i++)
    {
      attributeMaps[i].addMapChangeListener(
        mapChangeListener
      );
    }
  }

  @Override
  public String getToolTipText(Object element)
  {
    return "#dummy#";
  }

  @Override
  public void update(ViewerCell cell)
  {
    if (cell.getElement() instanceof Project)
    {
      Project p = (Project)cell.getElement();

      StyledString styledString = new StyledString(
        p.getShortname()!=null ? p.getShortname():"*noname*",
        null
      );
      String decoration = " (" +
        p.getCommitters().size() + " Committers)";
      styledString.append(
        decoration,
        StyledString.COUNTER_STYLER
      );
      cell.setText(styledString.getString());
      cell.setImage(projectImage);
      cell.setStyleRanges(styledString.getStyleRanges());
    }
    else if (cell.getElement() instanceof CommitterShip)
    {
      Person p = (
        (CommitterShip)cell.getElement()
      ).getPerson();
      String value = "*noname*";
      if (p != null)
      {
        value = p.getLastname() + ", " + p.getFirstname();
      }
      StyledString styledString = new StyledString(
        value, null);
      cell.setText(styledString.getString());
      cell.setForeground(
        cell.getControl().getDisplay().getSystemColor(
          SWT.COLOR_DARK_GRAY
        )
      );
      cell.setImage(committerImage);
      cell.setStyleRanges(styledString.getStyleRanges());
    }
  }
}

и используется как это

private TreeViewer init(Composite parent,
  Foundation foundation)
{
  TreeViewer viewer = new TreeViewer(parent);
  ObservableListTreeContentProvider cp =
    new ObservableListTreeContentProvider(
      new TreeFactoryImpl(),
      new TreeStructureAdvisorImpl()
  );
  viewer.setContentProvider(cp);

  IObservableSet set = cp.getKnownElements();
  IObservableMap[] map = new IObservableMap [4];

  map[0] = EMFProperties.value(
    ProjectPackage.Literals.PROJECT__SHORTNAME
  ).observeDetail(set);

  map[1] = EMFProperties.value(
    ProjectPackage.Literals.PROJECT__COMMITTERS
  ).observeDetail(set);

  map[2] = EMFProperties.value(
      FeaturePath.fromList(
        ProjectPackage.Literals.COMMITTER_SHIP__PERSON,
        ProjectPackage.Literals.PERSON__FIRSTNAME)
      ).observeDetail(set);

  map[3] = EMFProperties.value(
      FeaturePath.fromList(
        ProjectPackage.Literals.COMMITTER_SHIP__PERSON,
        ProjectPackage.Literals.PERSON__LASTNAME)
      ).observeDetail(set);

  viewer.setLabelProvider(new TreeLabelProviderImpl(map));
  // Further viewer setup

Последний шаг — установить входную информацию средства просмотра, которое должно быть IObservableList, которое в нашем примере является всеми проектами верхнего уровня, которые восстанавливаются в базовом экземпляре.

IEMFListProperty projects = EMFProperties.list(
  ProjectPackage.Literals.FOUNDATION__PROJECTS
);
viewer.setInput(projects.observe(foundation));

В ProjectExplorerPart содержится еще больше кода, например настраиваемый ColumnViewerToolTipSupport для создания приятных на вид подсказок при наведении на элементы дерева, а также некоторый RCP-код, позволяющий plugin.xml добавлять контекстное меню, но это стандартный код JFace и RCP.

От http://tomsondev.bestsolution.at

d