Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorslewis2009-04-16 20:09:26 -0400
committerslewis2009-04-16 20:09:26 -0400
commitcae2aafcfc36510165e8b082c20d00254e5f0ed6 (patch)
tree6a6f7f743fc6abea57fab9934dc50213cd3f0c06
parent29ca20637314d6909feb2dc11d7bb1cdc01e6464 (diff)
downloadorg.eclipse.ecf-cae2aafcfc36510165e8b082c20d00254e5f0ed6.tar.gz
org.eclipse.ecf-cae2aafcfc36510165e8b082c20d00254e5f0ed6.tar.xz
org.eclipse.ecf-cae2aafcfc36510165e8b082c20d00254e5f0ed6.zip
Added IRemoteServiceContainerAdapter.getAllRemoteServiceReferences
-rw-r--r--framework/bundles/org.eclipse.ecf.remoteservice/src/org/eclipse/ecf/remoteservice/IRemoteServiceContainerAdapter.java36
1 files changed, 36 insertions, 0 deletions
diff --git a/framework/bundles/org.eclipse.ecf.remoteservice/src/org/eclipse/ecf/remoteservice/IRemoteServiceContainerAdapter.java b/framework/bundles/org.eclipse.ecf.remoteservice/src/org/eclipse/ecf/remoteservice/IRemoteServiceContainerAdapter.java
index c88cac795..96173f8b3 100644
--- a/framework/bundles/org.eclipse.ecf.remoteservice/src/org/eclipse/ecf/remoteservice/IRemoteServiceContainerAdapter.java
+++ b/framework/bundles/org.eclipse.ecf.remoteservice/src/org/eclipse/ecf/remoteservice/IRemoteServiceContainerAdapter.java
@@ -260,6 +260,42 @@ public interface IRemoteServiceContainerAdapter extends IAdaptable {
public IFuture asyncGetRemoteServiceReferences(ID target, String clazz, String filter);
/**
+ * <p>
+ * Returns an array of <code>IRemoteServiceReference</code> objects. The
+ * returned array of <code>IRemoteServiceReference</code> objects contains
+ * services that were registered under the specified class, or if the clazz
+ * parameter is <code>null</code> all services registered.
+ * </p>
+ * <p>
+ * The list is valid at the time of the call to this method, however since
+ * the remote service container is a very dynamic environment, services can be modified or
+ * unregistered at anytime.
+ * </p>
+ * <p>
+ * <code>filter</code> is used to select the registered service whose
+ * properties objects contain keys and values which satisfy the filter. See
+ * {@link Filter} for a description of the filter string syntax.
+ * </p>
+ * <p>
+ * If <code>filter</code> is <code>null</code>, all registered services
+ * are considered to match the filter. If <code>filter</code> cannot be
+ * parsed, an {@link InvalidSyntaxException} will be thrown with a human
+ * readable message where the filter became unparsable.
+ * </p>
+ * @param clazz
+ * the fully qualified name of the interface class that describes
+ * the desired service. May be <code>null</code>.
+ * @param filter
+ * The filter criteria. May be <code>null</code>.
+ * @return Array of IRemoteServiceReferences matching given search criteria or
+ * <code>null</code> if no services are found that match the search.
+ *
+ * @throws InvalidSyntaxException If filter contains an invalid filter string that cannot be parsed.
+ * @since 3.0
+ */
+ public IRemoteServiceReference[] getAllRemoteServiceReferences(String clazz, String filter) throws InvalidSyntaxException;
+
+ /**
* Get namespace to use for this remote service provider.
* @return Namespace to use for creating IRemoteServiceID for this remote service provider. Will
* not return <code>null</code>.

Back to the top