Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'target_explorer/plugins/org.eclipse.tcf.te.tcf.locator/src/org/eclipse/tcf/te/tcf/locator/interfaces/services/IPeerModelUpdateService.java')
-rw-r--r--target_explorer/plugins/org.eclipse.tcf.te.tcf.locator/src/org/eclipse/tcf/te/tcf/locator/interfaces/services/IPeerModelUpdateService.java81
1 files changed, 81 insertions, 0 deletions
diff --git a/target_explorer/plugins/org.eclipse.tcf.te.tcf.locator/src/org/eclipse/tcf/te/tcf/locator/interfaces/services/IPeerModelUpdateService.java b/target_explorer/plugins/org.eclipse.tcf.te.tcf.locator/src/org/eclipse/tcf/te/tcf/locator/interfaces/services/IPeerModelUpdateService.java
new file mode 100644
index 000000000..ca2734a98
--- /dev/null
+++ b/target_explorer/plugins/org.eclipse.tcf.te.tcf.locator/src/org/eclipse/tcf/te/tcf/locator/interfaces/services/IPeerModelUpdateService.java
@@ -0,0 +1,81 @@
+/*******************************************************************************
+ * 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.tcf.locator.interfaces.services;
+
+import java.util.Collection;
+
+import org.eclipse.tcf.protocol.IPeer;
+import org.eclipse.tcf.te.tcf.locator.interfaces.nodes.IPeerNode;
+
+
+/**
+ * The service to update the properties of given locator model nodes.
+ */
+public interface IPeerModelUpdateService extends IPeerModelService {
+
+ /**
+ * Adds the given peer to the list of know peers.
+ * <p>
+ * A previous mapping to a peer model with the same id as the given peer model is overwritten.
+ *
+ * @param peer The peer model object. Must not be <code>null</code>.
+ */
+ public void add(IPeerNode peer);
+
+ /**
+ * Removes the given peer from the list of known peers.
+ *
+ * @param peer The peer model object. Must not be <code>null</code.
+ */
+ public void remove(IPeerNode peer);
+
+ /**
+ * Update the service nodes of the given peer node with the new set of
+ * local and/or remote services.
+ *
+ * @param peerNode The peer model instance. Must not be <code>null</code>.
+ * @param localServices The list of local service names or <code>null</code>.
+ * @param remoteServices The list of remote service names or <code>null</code>.
+ */
+ public void updatePeerServices(IPeerNode peerNode, Collection<String> localServices, Collection<String> remoteServices);
+
+ /**
+ * Adds the given child peer to the parent peer.
+ * <p>
+ * <b>Note:</b> The parent peer node is determined by calling {@link IPeerNode#getParentNode()}.
+ * The call has to return a non-null value, otherwise {@link #addChild(IPeerNode)}
+ * will do nothing.
+ *
+ * @param parent The parent peer model node. Must not be <code>null</code>.
+ * @param child The child peer model object. Must not be <code>null</code>.
+ */
+ public void addChild(IPeerNode child);
+
+ /**
+ * Removes the given child peer from the parent peer.
+ * <p>
+ * <b>Note:</b> The parent peer node is determined by calling {@link IPeerNode#getParentNode()}.
+ * The call has to return a non-null value, otherwise {@link #removeChild(IPeerNode)}
+ * will do nothing.
+ *
+ * @param parent The parent peer model node. Must not be <code>null</code>.
+ * @param child The child peer model object. Must not be <code>null</code>.
+ */
+ public void removeChild(IPeerNode child);
+
+ /**
+ * Merge user defined peer attributes from the given peer into the given peer node.
+ *
+ * @param node The peer node. Must not be <code>null</code>.
+ * @param peer The peer. Must not be <code>null</code>.
+ * @param force If <code>true</code>, the peer attributes are merged even if the peer id's don't match.
+ */
+ public void mergeUserDefinedAttributes(IPeerNode node, IPeer peer, boolean force);
+}

Back to the top