JDeveloper Deployment of WAR Files to Tomcat

Question

Hello
I'm new to learning JSP development, using JDeveloper (10.1.3) and Tomcat(5.5)/Jakarta ISAPI Redirector (1.2.14) on top of IIS. I'm just starting to get the hang of web applications and directory structures. So far I've been manually copying my classes and HTML/JSP files from development to deployment directories but now I want to use the JDeveloper IDE to manage my files and deploy them as my projects get more complex. I have a problem that I'm pulling my hair out about: When I deploy my application using JDeveloper via a WAR archive none of my JSP or HTML pages get served to my browser correctly. For example, a simple "hello world" page will not display anything in my browser. A check of the source code of the web page yields an empty document. This is the case for both HTML and JSP pages. The odd thing is that servlets work. If I type a URL to a servlet inside my application, it works fine. Now if I delete the WAR file and the deployment directory and copy the application files over manually, everything works as expected in the web browser. The culprit (I think) is the WEB-INF\web.xml file. In my manual copy process, I do not have a web.xml file. The text I'm studying from says I don't need it for the simple apps I've done so far. However, JDeveloper requires one for deployment and since I don't know what to put in it, I leave the default contents alone. So my question is: What do I need to do to the WEB-INF\web.xml file to make sure deployed-from-JDeveloper application is able to process HTML and JSP pages? A second question would be: Is there a way to configure JDeveloper such that I don't have to have a web.xml file?
Thanks.

Answer 1

You need to access your .jsp pages using the ADF Faces filter, for example:
http://localhost/dev/faces/default.jsp
The "/faces" part of the URL tells Tomcat to use the ADF faces filter you installed to process the page. You can specify the name of the filter in the web.xml file along with other data such as security constraints. I can't recall for sure, but I thought JDev set up the base web.xml for you including the ADF Filter lines as part of the install.
Below is a sample web.xml I use for Tomcat 5.5.9 (note on the cpxfilename context-param you would need to specify your jdev app name.) Hope this helps.
<?xml version = '1.0' encoding = 'windows-1252'?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee">
<description>YourDomain.com</description>
<context-param>
<param-name>javax.faces.STATE_SAVING_METHOD</param-name>
<param-value>client</param-value>
</context-param>
<context-param>
<param-name>oracle.adf.view.faces.CLIENT_STATE_METHOD</param-name>
<param-value>all</param-value>
</context-param>
<context-param>
<param-name>CpxFileName</param-name>
<param-value>com.yourappname.view.DataBindings</param-value>
</context-param>
<filter>
<filter-name>adfBindings</filter-name>
<filter-class>oracle.adf.model.servlet.ADFBindingFilter</filter-class>
</filter>
<filter>
<filter-name>adfFaces</filter-name>
<filter-class>oracle.adf.view.faces.webapp.AdfFacesFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>adfBindings</filter-name>
<url-pattern>*.jsp</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>adfBindings</filter-name>
<url-pattern>*.jspx</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>adfFaces</filter-name>
<url-pattern>*.jsp</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>adfFaces</filter-name>
<url-pattern>*.jspx</url-pattern>
</filter-mapping>
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>resources</servlet-name>
<servlet-class>oracle.adf.view.faces.webapp.ResourceServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>/faces/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>resources</servlet-name>
<url-pattern>/adf/*</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>10</session-timeout>
</session-config>
<mime-mapping>
<extension>html</extension>
<mime-type>text/html</mime-type>
</mime-mapping>
<mime-mapping>
<extension>txt</extension>
<mime-type>text/plain</mime-type>
</mime-mapping>
<!-- Define Security Constraints on this Application -->
<security-constraint>
<web-resource-collection>
<web-resource-name>Admin-Access</web-resource-name>
<url-pattern>/Admin/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>admin</role-name>
</auth-constraint>
</security-constraint>
<!-- Define the Login Configuration for this Application -->
<login-config>
<auth-method>DIGEST</auth-method>
<realm-name>AppAdmin</realm-name>
</login-config>
<!-- Security roles referenced by this web application -->
<security-role>
<description>
Role to access admin pages
</description>
<role-name>admin</role-name>
</security-role>
</web-app>