HTTP test runner

Some tests in uPortal 3 that use classes from javax.servlet.* in their runtime environment need to be executed within a servlet container.
Package org.jasig.portal.servlet in tests directory contains the following basic classes extending JUnit test functionality:

Test Servlet

This servlet performs HTTP tests using Reflection API and sends reports to the HTTP test runner which is a standalone Java application.
It uses the Spring config file to register HTTP test beans. uPortal 3 registers this servlet and its mappings in the web.xml.

<servlet>
        <servlet-name>TestServlet</servlet-name>
        <display-name>Test servlet</display-name>
        <servlet-class>org.jasig.portal.servlet.TestServlet</servlet-class>
        <init-param>
            <param-name>contextFileName</param-name>
            <param-value>test_servlet_beans.xml</param-value>
        </init-param>
</servlet>
 ...
<!-- uPortal test services -->
<servlet-mapping>
        <servlet-name>TestServlet</servlet-name>
        <url-pattern>/TestServlet/*</url-pattern>
</servlet-mapping>

Where contextFileName is the URI to the beans Spring configuration file.
In the example above test beans are defined in the file test_servlet_beans.xml located in the same package:

<beans default-lazy-init="true">
         
    <bean id="containerTest" class="org.jasig.portal.portlet.container.HttpContainerTestBean" singleton="true">
    </bean>
	
    <bean id="portletUrlTest" class="org.jasig.portal.portlet.url.PortletUrlTest" singleton="true">
    </bean>
	
    <bean id="wsrpContainerTest" class="org.jasig.portal.wsrp.WsrpPortletContainerHttpTestBean" singleton="true">
    </bean>
	
</beans>

HTTP Test Runner

It works as a standalone socket server accepting TCP/IP connections from the test servlet and showing results of the tests run by that servlet.
Connects to the test servlet to execute HTTP tests specified by the parameters:

1. bean - defines the name of the test bean
2. method - defines the name of the test method to be executed
3. connect - if true the test servlet will send the report to the HTTP test runner
   The httptestrunner.properties sets the port number of the socket server and the test servlet URL.

   # The test runner properties
   # Server socket port for communication with the test servlet
   server_socket_port = 10999
   # Tomcat port
   web_app_port = 8080
   # Test servlet URL, must start with "/"
   servletUrl = /uP3/TestServlet
   

   The test runner reads the list of test beans from the same Spring configuration file which URL is provided by the test servlet.

   HttpTestCase class

   It is an extension of JUnit's TestCase with its own initTest() method to initialize a test bean with ServletConfig, HttpServletRequest and HttpServletResponse. Accepts all assertions supported by JUnit. Subclasses need to be registered within the Spring config file of the test servlet. PortletUrlTest is an example of the HTTP test bean:
   PortletUrlTest.java

   /* Copyright 2004 The JA-SIG Collaborative.  All rights reserved.
    * See license distributed with this file and
    * available online at http://www.uportal.org/license.html
    */
   package org.jasig.portal.portlet.url;
   
   ...
   
   import org.jasig.portal.servlet.HttpTestCase;
   
   
   /**
    * Tests for the IPortletUrl impls
    *
    * @author Michael Ivanov: mivanov at unicon.net
    *
    */
   public class PortletUrlTest extends HttpTestCase {
   
       ...
       
       /**
        * @see TestCase#setUp()
        */
       protected void setUp() throws Exception {
           
       }
       
       private IPortletWindow getTestPortletWindow() {
       	return new PortletWindowImpl(new PortletEntityImpl(),PortletIdFactory.createPortletWindowId("1")); 
       }
   
       public void testUrlProcessor() {
       	
       	String param1 = "param1";
       	String param2 = "param2";
       	String value11 = "value11";
       	String value21 = "value21";
       	String value22 = "value22";
       	
       	IPortletWindow window  = getTestPortletWindow();
       	
       	PortletRequestParameterProcessor processor = new PortletRequestParameterProcessor();
       	IPortletWindowManager windowManager = new MockPortletWindowManager();
       	IPortletParameterSyntaxProvider syntaxProvider = new PortletParameterSyntaxProviderImpl();
       	
       	processor.setWindowManager(windowManager);
       	processor.setParameterSyntaxProvider(syntaxProvider);
       	
           // Writing parameters into request
       	WritableHttpServletRequestImpl writer = new WritableHttpServletRequestImpl(getRequest());
       	writer.setParameterValues(syntaxProvider.getRequestParameterName(param1,window.getObjectId()),new String[] { value11 });
       	writer.setParameterValues(syntaxProvider.getRequestParameterName(param2,window.getObjectId()),new String[] { value21, value22 });
       	writer.setParameterValues(syntaxProvider.getWindowStateCommandName(window.getObjectId()),new String[] { WindowState.MAXIMIZED.toString() });
       	writer.setParameterValues(syntaxProvider.getPortletModeCommandName(window.getObjectId()),new String[] { PortletMode.HELP.toString() });
       	writer.setParameterValues(syntaxProvider.getActionTargetCommandName(),new String[] { window.getObjectId().toString() });
       	
       	// Checking the syntax provider
       	assertTrue(syntaxProvider.isPortletModeCommand(syntaxProvider.getPortletModeCommandName(window.getObjectId())));
       	assertTrue(syntaxProvider.isWindowStateCommand(syntaxProvider.getWindowStateCommandName(window.getObjectId())));
       	assertTrue(syntaxProvider.isPortletParameter(syntaxProvider.getRequestParameterName(param1,window.getObjectId())));
       	assertTrue(syntaxProvider.isPortletParameter(syntaxProvider.getRequestParameterName(param2,window.getObjectId())));
       	
       	// Parameter processing
       	processor.processParameters(writer,getResponse());
       	
       	assertEquals(windowManager.getPortletMode(window.getObjectId(),getRequest()),PortletMode.HELP);
       	assertEquals(windowManager.getWindowState(window.getObjectId(),getRequest()),WindowState.MAXIMIZED);
       	assertEquals(syntaxProvider.getRealParameterName(syntaxProvider.getRequestParameterName(param1,window.getObjectId())),param1);
       	assertEquals(syntaxProvider.getRequestParameterName(param2,window.getObjectId()),
           syntaxProvider.getRequestParameterName(syntaxProvider.getRealParameterName(syntaxProvider.getRequestParameterName(param2,window.getObjectId())),window.getObjectId()));
       	
       	
       }
   
       // Some other test methods
       ...
       
   }