GenericsTest.java

package com.thoughtworks.qdox;

import com.thoughtworks.qdox.model.*;
import com.thoughtworks.qdox.model.impl.DefaultJavaParameterizedType;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

import java.io.StringReader;
import java.util.Collections;

import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.when;

/**
 * @author <a href="mailto:joew@thoughtworks.com">Joe Walnes</a>
 * @author Aslak Helles&oslash;y
 * @author Mike Williams
 */
public class GenericsTest {
    
    private JavaProjectBuilder builder = new JavaProjectBuilder();

    @Test
    public void testShouldUnderstandSingleGenericClassDeclarations() {
        String source = "" +
                "public interface Foo<T> extends Bar<T> {}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Foo", builder.getClassByName("Foo").getName());
    }

    @Test
    public void testShouldUnderstandMultipleGenericClassDeclarations() {
        String source = "" +
                "public interface Foo<X,Y> extends Bar<X,Y> {}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Foo", builder.getClassByName("Foo").getName());
    }

    @Test
    public void testShouldUnderstandMultipleGenericsInMethodDeclarations() {
        String source = "" +
                "public interface Foo {" +
                "   Bar<X,Y> zap(Zip<R,V> r);" +
                "}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Foo", builder.getClassByName("Foo").getName());
    }

    @Test
    public void testShouldUnderstandOuterAndInnerClassGenericsInMethodDeclarations() {
        String source = "" +
                "    public interface Foo {\n" +
                "       <A,B> void zap(Outer<A>.Inner<B> arg);\n" +
                "    }";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Foo", builder.getClassByName("Foo").getName());
    }

    @Test
    public void testShouldUnderstandMultipleGenericsInConstructorDeclarations() {
        String source = "" +
                "public class Bar {" +
                "   public Bar(Zip<R,V> r) {}" +
                "}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandMultipleGenericsInFieldDeclarations() {
        String source = "" +
                "public class Bar {" +
                "   private Foo<R,V> foo;" +
                "}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandNestedGenerics() {
        String source = "" +
                "public class Bar {" +
                "   private List<List<Integer>> listOfLists;" +
                "}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandFullyQualifiedTypeArguments() {
        String source = "" +
                "public class Bar {" +
                "   private List<java.util.Date> listOfDates;" +
                "}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandBoundedTypeParameters() {
        String source = "" +
                "public class Bar<T extends Date> {}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandComplexBoundedTypeParameters() {
        String source = "" +
                "public class Bar<T extends Date & Serializable> {}";

        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandWildcardTypeArguments() {
        String source = "" +
                "public class Bar { private Class<? extends Date> klass; }";
        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandBoundedWildcardTypeArguments() {
        String source = "" +
                "public class Bar { Map<? super String, ? extends Date> klass; }";
        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandMethodTypeParameters() {
        String source = "" +
                "public class Bar {" +
                "    public static <T extends Comparable<T>> T max(Collection<T> collection) {" +
                "        throw new UnsupportedOperationException();" +
                "    }" +
                "}";
        builder.addSource(new StringReader(source));
        Assertions.assertEquals("Bar", builder.getClassByName("Bar").getName());
    }

    @Test
    public void testShouldUnderstandAnnotationsOnTypeParameters() {
        String source = "import com.foo.Item;\n" +
                "public class Bar {\n" +
                "    public static Collection<Item> foo() { }\n" +
                "    public static Collection<com.foo.Item> foo2() { }\n" +
                "    public static Collection<@Annot Item> foo3() { }\n" +
                "    public static Collection<@Annot com.foo.Item> foo4() { }\n" +
                "    public static Collection<com.foo.@Annot Item> foo5() { }\n" +
                "}";
        builder.addSource(new StringReader(source));
        JavaClass bar = builder.getClassByName("Bar");
        Assertions.assertEquals("Bar", bar.getName());

        Assertions.assertEquals(builder.getClassByName("com.foo.Item"), (( (DefaultJavaParameterizedType)bar.getMethods().get(0).getReturns()).getActualTypeArguments().get(0)));
        Assertions.assertEquals(builder.getClassByName("com.foo.Item"), (( (DefaultJavaParameterizedType)bar.getMethods().get(1).getReturns()).getActualTypeArguments().get(0)));
        Assertions.assertEquals(builder.getClassByName("com.foo.Item"), (( (DefaultJavaParameterizedType)bar.getMethods().get(2).getReturns()).getActualTypeArguments().get(0)));
        Assertions.assertEquals(builder.getClassByName("com.foo.Item"), (( (DefaultJavaParameterizedType)bar.getMethods().get(3).getReturns()).getActualTypeArguments().get(0)));
        Assertions.assertEquals(builder.getClassByName("com.foo.Item"), (( (DefaultJavaParameterizedType)bar.getMethods().get(4).getReturns()).getActualTypeArguments().get(0)));
    }

    @Test
    public void testGenericField() {
        // Also see QDOX-77
        String source = "" +
            "public class Foo {\n" +
            "    protected Map<String, Object> m_env = new HashMap();\n" +
            "    public Object retrieve(Class klass, Object key) {\n" +
            "        return x;\n" +
            "    }\n" +
            "}\n";
        builder.addSource(new StringReader(source));
        
        JavaClass fooClass = builder.getClassByName("Foo");
        Assertions.assertNotNull(fooClass);
        Assertions.assertEquals("Foo", fooClass.getName());
        
        JavaField envField = fooClass.getFieldByName("m_env");
        Assertions.assertNotNull(envField);
        Assertions.assertEquals("Map", envField.getType().getValue());
    }

    @Test
    public void testGenericFieldInstantiation() {
        // Also see QDOX-77
        String source = "" +
            "public class Foo {\n" +
            "    protected Map<String, Object> m_env = new HashMap<String, Object>();\n" +
            "    public Object retrieve(Class klass, Object key) {\n" +
            "        return x;\n" +
            "    }\n" +
            "}\n";
        builder.addSource(new StringReader(source));
        
        JavaClass fooClass = builder.getClassByName("Foo");
        Assertions.assertNotNull(fooClass);
        Assertions.assertEquals("Foo", fooClass.getName());
        
        JavaField envField = fooClass.getFieldByName("m_env");
        Assertions.assertNotNull(envField);
        Assertions.assertEquals("Map", envField.getType().getValue());
    }

    @Test
    public void testGenericFieldInstantiationHalfComplex() {
        // Also see QDOX-77
        String source = "" +
            "public class Foo {\n" +
            "    protected Map<Class<?>, Object> m_env = new HashMap<Class<?>, Object>();\n" +
            "    public Object retrieve(Class klass, Object key) {\n" +
            "        return x;\n" +
            "    }\n" +
            "}\n";
        builder.addSource(new StringReader(source));
        
        JavaClass fooClass = builder.getClassByName("Foo");
        Assertions.assertNotNull(fooClass);
        Assertions.assertEquals("Foo", fooClass.getName());
        
        JavaField envField = fooClass.getFieldByName("m_env");
        Assertions.assertNotNull(envField);
        Assertions.assertEquals("Map", envField.getType().getValue());
    }

    @Test
    public void testGenericFieldInstantiationComplex() {
        // Also see QDOX-77
        String source = "" +
            "public class Foo {\n" +
            "    protected Map<Class<? extends Serializable>, Object> m_env = new HashMap<Class<? extends Serializable>, Object>();\n" +
            "    public Object retrieve(Class klass, Object key) {\n" +
            "        return x;\n" +
            "    }\n" +
            "}\n";
        builder.addSource(new StringReader(source));
        
        JavaClass fooClass = builder.getClassByName("Foo");
        Assertions.assertNotNull(fooClass);
        Assertions.assertEquals("Foo", fooClass.getName());
        
        JavaField envField = fooClass.getFieldByName("m_env");
        Assertions.assertNotNull(envField);
        Assertions.assertEquals("Map", envField.getType().getValue());
    }

    @Test
    public void testGenericFieldInstantiationVeryComplex() {
        // Also see QDOX-77
        String source = "" +
            "public class Foo {\n" +
            "    protected Map<Map<Class<? extends Serializable>, ?>, Object> m_env = new HashMap<? extends Map<Class<? extends Serializable>, Object>, Object>();\n" +
            "    public Object retrieve(Class klass, Object key) {\n" +
            "        return x;\n" +
            "    }\n" +
            "}\n";
        builder.addSource(new StringReader(source));
        
        JavaClass fooClass = builder.getClassByName("Foo");
        Assertions.assertNotNull(fooClass);
        Assertions.assertEquals("Foo", fooClass.getName());
        
        JavaField envField = fooClass.getFieldByName("m_env");
        Assertions.assertNotNull(envField);
        Assertions.assertEquals("Map", envField.getType().getValue());
    }

    @Test
    public void testJiraQdox66() {
        // Also see QDOX-77
        String source = "" +
            "public class Foo {\n" +
            "    protected Map<String, Object> m_env = new HashMap<String, Object>();\n" +
            "    public <T extends Object> T retrieve(Class<T> klass, Object key) {\n" +
            "        return x;\n" +
            "    }\n" +
            "}\n";
        builder.addSource(new StringReader(source));
        
        JavaClass fooClass = builder.getClassByName("Foo");
        Assertions.assertNotNull(fooClass);
        Assertions.assertEquals("Foo", fooClass.getName());
        
        JavaField envField = fooClass.getFieldByName("m_env");
        Assertions.assertNotNull(envField);
        Assertions.assertEquals("Map", envField.getType().getValue());
    } 
    
    // QDOX-207
    @Test
    public void testMethodReturnTypeExtends() {
        String superSource = "public abstract class Test<T> {\n" + 
        		"        private T me;\n" + 
        		"        public Test(T me) {\n" + 
        		"            this.me = me;\n" + 
        		"        }\n" + 
        		"        public T getValue() {\n" + 
        		"            return me;\n" + 
        		"        }\n" + 
        		"    }";
        String subSource = "public class StringTest extends Test<String> {\n" + 
        		"        public StringTest(String s) {\n" + 
        		"            super(s);\n" + 
        		"        }\n" + 
        		"    }";
        builder.addSource( new StringReader( superSource ) );
        builder.addSource( new StringReader( subSource ) );
        JavaMethod method = builder.getClassByName( "StringTest" ).getMethodBySignature( "getValue", null, true );
        Assertions.assertEquals("T", method.getReturnType(false).getValue());
        Assertions.assertEquals("java.lang.Object", method.getReturnType().getFullyQualifiedName());
        Assertions.assertEquals("java.lang.Object", method.getReturnType( false ).getFullyQualifiedName());
        Assertions.assertEquals("java.lang.String", method.getReturnType( true ).getFullyQualifiedName());
    }
    
    //GWT-186
    @Test
    public void testMethodReturnTypeImplements() {
        String source1="public interface GenericDao<TEntity, TKey> {\n" + 
        		"public List<TEntity> getAll();\n" + 
                "public TEntity getRandom();\n" + 
        		"public TEntity findById(TKey key);\n" + 
        		"public TEntity persist(TEntity entity);\n" + 
        		"public TEntity[] persist(TEntity[] entities);\n" + 
        		"public void delete(TEntity entity);\n" + 
        		"public Map<TKey, TEntity> asMap();" +
        		"}\r\n";
        String source2="public interface SubjectDao extends GenericDao<Subject, Long> {\n" + 
        		"public List<Subject> getEnabledSubjects();\n" + 
        		"}\r\n";
        String source3="public interface SubjectService extends RemoteService, SubjectDao {\r\n" + 
        		"}";
        builder.addSource( new StringReader( source1 ) );
        builder.addSource( new StringReader( source2 ) );
        builder.addSource( new StringReader( source3 ) );
        JavaMethod method = builder.getClassByName( "GenericDao" ).getMethodBySignature( "getRandom", null, true );
        Assertions.assertEquals("TEntity", method.getReturnType( true ).getGenericValue());
        method = builder.getClassByName( "GenericDao" ).getMethodBySignature( "getAll", null, true );
        Assertions.assertEquals("List<TEntity>", method.getReturnType( true ).getGenericValue());
        method = builder.getClassByName( "GenericDao" ).getMethodBySignature( "asMap", null, true );
        Assertions.assertEquals("Map<TKey,TEntity>", method.getReturnType( true ).getGenericValue());

        method = builder.getClassByName( "SubjectDao" ).getMethodBySignature( "getRandom", null, true );
        Assertions.assertEquals("Subject", method.getReturnType( true ).getGenericValue());
        method = builder.getClassByName( "SubjectDao" ).getMethodBySignature( "getAll", null, true );
        Assertions.assertEquals("List<Subject>", method.getReturnType( true ).getGenericValue());
        method = builder.getClassByName( "SubjectDao" ).getMethodBySignature( "asMap", null, true );
        Assertions.assertEquals("Map<java.lang.Long,Subject>", method.getReturnType( true ).getGenericFullyQualifiedName());
        Assertions.assertEquals("Map<Long,Subject>", method.getReturnType( true ).getGenericValue());
        
        method = builder.getClassByName( "SubjectService" ).getMethodBySignature( "getRandom", null, true );
        Assertions.assertEquals("Subject", method.getReturnType( true ).getGenericValue());
        method = builder.getClassByName( "SubjectService" ).getMethodBySignature( "getAll", null, true );
        Assertions.assertEquals("List<Subject>", method.getReturnType( true ).getGenericValue());
        method = builder.getClassByName( "SubjectService" ).getMethodBySignature( "asMap", null, true );
        Assertions.assertEquals("Map<java.lang.Long,Subject>", method.getReturnType( true ).getGenericFullyQualifiedName());
        Assertions.assertEquals("Map<Long,Subject>", method.getReturnType( true ).getGenericValue());
        
        JavaType tEntity = mock( JavaType.class );
        when( tEntity.getFullyQualifiedName() ).thenReturn( "TEntity[]" );
        method = builder.getClassByName( "SubjectDao" ).getMethodBySignature( "persist", Collections.singletonList( tEntity ), true );
        Assertions.assertNotNull(method);
        Assertions.assertEquals("Subject[]", method.getParameterTypes( true ).get( 0 ).getGenericFullyQualifiedName());
    }
    
    //for QDOX-210
    @Test
    public void testResolveTypeGetMethod() {
        String source1="import java.util.*;" +
        "public interface GenericDao<TEntity, TKey> {\n" + 
        "public List<TEntity> getAll();\n" + 
        "public TEntity getRandom();\n" + 
        "public TEntity findById(TKey key);\n" + 
        "public TEntity persist(TEntity entity);\n" + 
        "public TEntity[] persist(TEntity[] entities);\n" + 
        "public void delete(TEntity entity);\n" + 
        "public Map<TKey, TEntity> asMap();" +
        "}\r\n";
        String source2="public interface SubjectDao extends GenericDao<Subject, Long> {\n" + 
        "}";
        String source3="public interface SubjectService extends RemoteService, SubjectDao {\r\n" + 
        "}";
        String source4="public interface RemoteService {}";
        builder.addSource( new StringReader( source1 ) );
        builder.addSource( new StringReader( source2 ) );
        builder.addSource( new StringReader( source3 ) );
        builder.addSource( new StringReader( source4 ) );
        
        JavaClass clazz = builder.getClassByName( "SubjectService" );
        JavaMethod method = clazz.getMethods( true ).get(0);
        Assertions.assertEquals("getAll", method.getName());
        Assertions.assertEquals("java.util.List<Subject>", method.getReturnType( true ).getGenericFullyQualifiedName());
        Assertions.assertEquals("List<Subject>", method.getReturnType( true ).getGenericValue());
        method = clazz.getMethods( true ).get(2);
        Assertions.assertEquals("findById", method.getName());
        Assertions.assertEquals("java.lang.Long", method.getParameterTypes( true ).get(0).getGenericFullyQualifiedName());
        Assertions.assertEquals("Long", method.getParameterTypes( true ).get(0).getGenericValue());
    }
    
    // for QDOX-239
    @Test
    public void testFieldWithWildcardType()
    {
       StringBuilder b = new StringBuilder("package test;\n");
       b.append("import java.util.ArrayList;\n");
       b.append("import java.util.Map;\n");
       b.append("public class TestClass<E>{\n");
       b.append("public ArrayList<? extends Map<String, E>> list;\n}");
       builder.addSource(new StringReader(b.toString()));
       JavaClass javaClass = builder.getClassByName( "test.TestClass" );
       JavaField field = javaClass.getFields().get( 0 );
       Assertions.assertTrue(field.getType() instanceof JavaParameterizedType);
       JavaParameterizedType paramType = (JavaParameterizedType) field.getType();
       Assertions.assertTrue(paramType.getActualTypeArguments().get( 0 ) instanceof JavaWildcardType);
       JavaWildcardType wildcardType = (JavaWildcardType) paramType.getActualTypeArguments().get( 0 );
       Assertions.assertEquals("? extends java.util.Map<java.lang.String,E>", wildcardType.getGenericFullyQualifiedName());
    }

}