Skip to main content
aboutsummaryrefslogtreecommitdiffstats
blob: 95d3f11f9a0d5cc2fcf8b1af1e15d0d37df301cb (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
/*******************************************************************************
 * Copyright (c) 2011, 2012 Wind River Systems, Inc. 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:
 * Wind River Systems - initial API and implementation
 *******************************************************************************/
package org.eclipse.tcf.te.runtime.extensions;

import java.util.Comparator;

import org.eclipse.core.runtime.IExtension;

/**
 * Extension point comparator implementation.
 * <p>
 * The comparator assure that extension are read in a predictable order.
 * <p>
 * The order of the extensions is defined as following:<br>
 * <ul><li>Extensions contributed by our own plug-ins (<code>org.eclipse.tcf.te.*</code>)
 *         in ascending alphabetic order and</li>
 *     <li>Extensions contributed by any other plug-in in ascending alphabetic order.</li>
 *     <li>Extensions contributed by the same plug-in in ascending alphabetic order by the
 *         extensions unique id</li>
 */
public class ExtensionPointComparator implements Comparator<IExtension> {
	private final static String OWN_PLUGINS_PATTERN = "org.eclipse.tcf.te."; //$NON-NLS-1$

	/* (non-Javadoc)
	 * @see java.util.Comparator#compare(java.lang.Object, java.lang.Object)
	 */
	@Override
    public int compare(IExtension o1, IExtension o2) {
		// We ignore any comparisation with null and
		if (o1 == null || o2 == null) return 0;
		// Check if it is the exact same element
		if (o1 == o2) return 0;

		// The extensions are compared by the unique id of the contributing plugin first
		String contributor1 = o1.getContributor().getName();
		String contributor2 = o2.getContributor().getName();

		// Contributions from our own plug-ins comes before 3rdParty plug-ins
		if (contributor1.startsWith(OWN_PLUGINS_PATTERN) && !contributor2.startsWith(OWN_PLUGINS_PATTERN))
			return -1;
		if (!contributor1.startsWith(OWN_PLUGINS_PATTERN) && contributor2.startsWith(OWN_PLUGINS_PATTERN))
			return 1;
		if (contributor1.startsWith(OWN_PLUGINS_PATTERN) && contributor2.startsWith(OWN_PLUGINS_PATTERN)) {
			int value = contributor1.compareTo(contributor2);
			// Within the same plug-in, the extension are sorted by their unique id (if available)
			if (value == 0 && o1.getUniqueIdentifier() != null && o2.getUniqueIdentifier() != null)
				return o1.getUniqueIdentifier().compareTo(o2.getUniqueIdentifier());
			// Otherwise, just return the comparisation result from the contributors
			return value;
		}

		// Contributions from all other plug-ins are sorted alphabetical
		int value = contributor1.compareTo(contributor2);
		// Within the same plug-in, the extension are sorted by their unique id (if available)
		if (value == 0 && o1.getUniqueIdentifier() != null && o2.getUniqueIdentifier() != null)
			return o1.getUniqueIdentifier().compareTo(o2.getUniqueIdentifier());
		// Otherwise, just return the comparisation result from the contributors
		return value;
	}

}

Back to the top