Add XPathContext.stream() and strengthen type of getValue(String, Class)

bundles/org.eclipse.e4.emf.xpath/.settings/.api_filters

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<component id="org.eclipse.e4.emf.xpath" version="2">
+    <resource path="src/org/eclipse/e4/emf/xpath/XPathContext.java" type="org.eclipse.e4.emf.xpath.XPathContext">
+        <filter id="404000815">
+            <message_arguments>
+                <message_argument value="org.eclipse.e4.emf.xpath.XPathContext"/>
+                <message_argument value="stream(String, Class&lt;T&gt;)"/>
+            </message_arguments>
+        </filter>
+    </resource>
+</component>

bundles/org.eclipse.e4.emf.xpath/META-INF/MANIFEST.MF

@@ -2,7 +2,7 @@ Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: %Bundle-Name
 Bundle-SymbolicName: org.eclipse.e4.emf.xpath
-Bundle-Version: 0.4.300.qualifier
+Bundle-Version: 0.5.0.qualifier
 Bundle-RequiredExecutionEnvironment: JavaSE-17
 Require-Bundle: org.eclipse.emf.ecore;bundle-version="2.35.0",
  org.eclipse.core.runtime;bundle-version="3.29.0"

bundles/org.eclipse.e4.emf.xpath/src/org/eclipse/e4/emf/internal/xpath/JXPathContextImpl.java

@@ -21,6 +21,7 @@
 import org.apache.commons.jxpath.JXPathContext;
 import org.apache.commons.jxpath.NodeSet;
 import org.apache.commons.jxpath.Pointer;
+import org.apache.commons.jxpath.util.TypeUtils;
 import org.eclipse.e4.emf.xpath.XPathContext;
 import org.eclipse.emf.ecore.EObject;
 
@@ -84,8 +85,11 @@ public Object getValue(String xpath) {
 	}
 
 	@Override
-	public Object getValue(String xpath, Class<?> requiredType) {
-		return context.getValue(xpath, requiredType);
+	public <T> T getValue(String xpath, Class<T> requiredType) {
+		Object value = context.getValue(xpath, requiredType);
+		@SuppressWarnings("unchecked")
+		T typedValue = (T) TypeUtils.convert(value, requiredType);
+		return typedValue;
 	}
 
 	@Override

bundles/org.eclipse.e4.emf.xpath/src/org/eclipse/e4/emf/xpath/XPathContext.java

@@ -14,6 +14,10 @@
 package org.eclipse.e4.emf.xpath;
 
 import java.util.Iterator;
+import java.util.Spliterator;
+import java.util.Spliterators;
+import java.util.stream.Stream;
+import java.util.stream.StreamSupport;
 
 /**
  * Context in which the xpath is executed
@@ -42,7 +46,7 @@ public interface XPathContext {
 	 *            required type
 	 * @return Object found
 	 */
-	Object getValue(String xpath, Class<?> requiredType);
+	<T> T getValue(String xpath, Class<T> requiredType);
 
 	/**
 	 * Traverses the xpath and returns an Iterator of all results found for the
@@ -55,4 +59,22 @@ public interface XPathContext {
 	 * @return Iterator&lt;Object&gt;
 	 */
 	<T> Iterator<T> iterate(String xpath);
+
+	/**
+	 * Traverses the xpath and returns an {@link Stream} of all results found for
+	 * the path. If the xpath matches no properties in the graph, the stream will be
+	 * empty.
+	 *
+	 * @param <T>   the expected object type
+	 * @param xpath the xpath expression to iterate
+	 * @param type  the type of elements in the returned stream
+	 * @return a stream of elements matching the specified xpath and of the given
+	 *         type
+	 * @since 0.5
+	 */
+	default <T> Stream<T> stream(String xpath, Class<T> type) {
+		Iterator<?> iterator = iterate(xpath);
+		return StreamSupport.stream(Spliterators.spliteratorUnknownSize(iterator, Spliterator.ORDERED), false) //
+				.filter(type::isInstance).map(type::cast);
+	}
 }

tests/org.eclipse.e4.emf.xpath.test/src/org/eclipse/e4/emf/xpath/test/ExampleQueriesApplicationTest.java

@@ -85,6 +85,9 @@ public void testAccessingTheMainMenu() {
 		Object menu = xpathContext.getValue("//mainMenu");
 		assertNotNull(menu);
 		assertTrue(menu instanceof MMenu);
+
+		MMenu mMenu = xpathContext.getValue("//mainMenu", MMenu.class);
+		assertNotNull(mMenu);
 	}
 
 	@Test

tests/org.eclipse.e4.emf.xpath.test/src/org/eclipse/e4/emf/xpath/test/ExampleQueriesTestCase.java

@@ -75,6 +75,9 @@ public void testSimpleQuery() {
 		assertNotNull(application);
 		assertSame(RootImpl.class, application.getClass());
 
+		RootImpl rootApplication = xpathContext.getValue("/", RootImpl.class);
+		assertNotNull(rootApplication);
+
 		application = xpathContext.getValue(".");
 		assertNotNull(application);
 		assertSame(RootImpl.class, application.getClass());
@@ -85,14 +88,19 @@ public void testSimpleQuery() {
 		assertNotNull(application);
 		assertSame(RootImpl.class, application.getClass());
 
+		rootApplication = xpathContext.getValue(".[@id='root']", RootImpl.class);
+		assertNotNull(rootApplication);
+
 		assertEquals("element1",xpathContext.getValue("nodes[1]/@id"));
 
 		assertEquals(NodeImpl.class, xpathContext.getValue("//.[@id='element2.2']").getClass());
 		assertEquals(ExtendedNodeImpl.class,xpathContext.getValue("//.[ecore:eClassName(.)='ExtendedNode']").getClass());
 
+		ExtendedNodeImpl extendedNode = xpathContext.getValue("//.[ecore:eClassName(.)='ExtendedNode']",
+				ExtendedNodeImpl.class);
+		assertNotNull(extendedNode);
 	}
 
-
 	@Test
 	public void testMenuQuery() {
 		Object application = xpathContext.getValue("/");