Skip to main content
summaryrefslogtreecommitdiffstats
blob: aa2b71f51a59c10963afcfd6ea412522439c031a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
/*
 * Copyright (c) 2004 - 2012 Eike Stepper (Berlin, Germany) and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *    Eike Stepper - initial API and implementation
 */
package org.eclipse.net4j.util.container;

import org.eclipse.net4j.util.container.IContainerDelta.Kind;
import org.eclipse.net4j.util.event.IEvent;
import org.eclipse.net4j.util.lifecycle.ILifecycle;
import org.eclipse.net4j.util.lifecycle.ShareableLifecycle;

import java.util.List;

/**
 * An abstract base implementation of a {@link IContainer container} with a {@link ILifecycle lifecycle}.
 *
 * @author Eike Stepper
 */
public abstract class Container<E> extends ShareableLifecycle implements IContainer<E>
{
  public Container()
  {
    this(false);
  }

  /**
   * @since 3.3
   */
  public Container(boolean shareable)
  {
    super(shareable);
  }

  public boolean isEmpty()
  {
    if (!isActive())
    {
      return true;
    }

    E[] elements = getElements();
    return elements == null || elements.length == 0;
  }

  @Override
  public void fireEvent(IEvent event)
  {
    if (event instanceof IContainerEvent<?>)
    {
      if (((IContainerEvent<?>)event).isEmpty())
      {
        return;
      }
    }

    super.fireEvent(event);
  }

  public void fireContainerEvent(E element, Kind kind)
  {
    fireEvent(newContainerEvent(element, kind));
  }

  public void fireElementAddedEvent(E element)
  {
    fireContainerEvent(element, IContainerDelta.Kind.ADDED);
  }

  public void fireElementRemovedEvent(E element)
  {
    fireContainerEvent(element, IContainerDelta.Kind.REMOVED);
  }

  /**
   * @since 2.0
   */
  public void fireContainerEvent(E[] elements, Kind kind)
  {
    ContainerEvent<E> event = new ContainerEvent<E>(this);
    for (E element : elements)
    {
      event.addDelta(element, kind);
    }

    fireEvent(event);
  }

  /**
   * @since 2.0
   */
  public void fireElementsAddedEvent(E[] elements)
  {
    fireContainerEvent(elements, IContainerDelta.Kind.ADDED);
  }

  /**
   * @since 2.0
   */
  public void fireElementsRemovedEvent(E[] elements)
  {
    fireContainerEvent(elements, IContainerDelta.Kind.REMOVED);
  }

  public void fireContainerEvent(List<IContainerDelta<E>> deltas)
  {
    fireEvent(new ContainerEvent<E>(this, deltas));
  }

  protected SingleDeltaContainerEvent<E> newContainerEvent(E element, IContainerDelta.Kind kind)
  {
    return new SingleDeltaContainerEvent<E>(this, element, kind);
  }

  protected ContainerEvent<E> newContainerEvent()
  {
    return new ContainerEvent<E>(this);
  }
}

Back to the top