Recent changes to Creating a Web Project

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 09 Jun 2019 21:49:53 -0000

--- v6
+++ v7
@@ -6,13 +6,6 @@
 3. Check ***Generate web.xml deployment descriptor*** and click Finish.

 Even though the servlets will be using annotations, you still need the web.xml file for cluster and security settings.  In addition, you may want to map library servlets (such as the Export servlet), which cannot be mapped any other way.
-
-#Required Files
-Copy the following files to the WebContent folder of your project.  They are found in the release or snapshot zip file.  They can also be found in RothDeveloper.war.  You don't need to customize them, but you can.
-
-* auth.jsp
-* error.jsp
-* login.jsp

 #web.xml
 Whether using in a cluster environment or not, it won't hurt to have the **distributable** tag.  That way if you do cluster later, you don't have to worry about it.  The best place for this is immediately after the **display-name** tag.
@@ -36,7 +29,7 @@
   
 ~~~

-Security.  This is important.  Roth uses form authentication.  This part goes at the bottom of the file before the **web-app** end tag.
+Security.  This is important.  Roth uses form authentication.  This part goes at the bottom of the file before the **web-app** end tag.  The JSP pages referenced are found in the Roth library JAR file, and are automatically referenced directly from there.
 ~~~
 :::xml
   <error-page>
</error-page>

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 17 Mar 2019 18:47:33 -0000

--- v5
+++ v6
@@ -55,7 +55,10 @@
 ~~~
 :::xml
 
-<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
+<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" +="" version="3.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID">
   <display-name>ExampleWebProject</display-name>
   <distributable>
   <welcome-file-list>
</welcome-file-list></distributable></web-app></web-app>

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 17 Mar 2019 18:46:43 -0000

--- v4
+++ v5
@@ -56,7 +56,7 @@
 :::xml
 
 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
-  <display-name>Roth</display-name>
+  <display-name>ExampleWebProject</display-name>
   <distributable>
   <welcome-file-list>
     <welcome-file>index.jsp</welcome-file>
</welcome-file-list></distributable></web-app>

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 17 Mar 2019 18:46:08 -0000

--- v3
+++ v4
@@ -50,3 +50,36 @@
     
   
 ~~~
+
+Full Example:
+~~~
+:::xml
+
+<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
+  <display-name>Roth</display-name>
+  <distributable>
+  <welcome-file-list>
+    <welcome-file>index.jsp</welcome-file>
+  </welcome-file-list>
+  <servlet>
+    <description></description>
+    <display-name>Export</display-name>
+    <servlet-name>Export</servlet-name>
+    <servlet-class>com.roth.servlet.ExportServlet</servlet-class>
+  </servlet>
+  <servlet-mapping>
+    <servlet-name>Export</servlet-name>
+    <url-pattern>/Export/*</url-pattern>
+  </servlet-mapping>
+  <error-page>
+    <location>/error.jsp</location>
+  </error-page>
+  <login-config>
+    <auth-method>FORM</auth-method>
+    <form-login-config>
+      <form-login-page>/login.jsp</form-login-page>
+      <form-error-page>/login.jsp?error=true</form-error-page>
+    </form-login-config>
+  </login-config>
+</distributable></web-app>
+~~~

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 17 Mar 2019 17:50:50 -0000

--- v2
+++ v3
@@ -3,7 +3,7 @@
 #Dynamic Web Project
 1. Right-click in the Project Explorer, and select **New** / **Dynamic Web Project**.
 2. Enter a name for the project, then click Next until you get to the last page of the wizard.
-3. Check *Generate web.xml deployment descriptor* and click Finish.
+3. Check ***Generate web.xml deployment descriptor*** and click Finish.

 Even though the servlets will be using annotations, you still need the web.xml file for cluster and security settings.  In addition, you may want to map library servlets (such as the Export servlet), which cannot be mapped any other way.

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 17 Mar 2019 17:18:46 -0000

--- v1
+++ v2
@@ -9,6 +9,7 @@

 #Required Files
 Copy the following files to the WebContent folder of your project.  They are found in the release or snapshot zip file.  They can also be found in RothDeveloper.war.  You don't need to customize them, but you can.
+
 * auth.jsp
 * error.jsp
 * login.jsp

Creating a Web Project modified by James M. Payne

James M. Payne — Sun, 17 Mar 2019 17:17:49 -0000

NOTE: These instructions use the simplest case, assuming the use of Eclipse. I am not a fan of Maven, so I will not be describing how to do this with Maven. However, if you are familiar with maven, I'm sure you can adjust as necessary.

Dynamic Web Project

Right-click in the Project Explorer, and select New / Dynamic Web Project.
Enter a name for the project, then click Next until you get to the last page of the wizard.
Check Generate web.xml deployment descriptor and click Finish.

Even though the servlets will be using annotations, you still need the web.xml file for cluster and security settings. In addition, you may want to map library servlets (such as the Export servlet), which cannot be mapped any other way.

Required Files

Copy the following files to the WebContent folder of your project. They are found in the release or snapshot zip file. They can also be found in RothDeveloper.war. You don't need to customize them, but you can.
auth.jsp
error.jsp
* login.jsp

web.xml

Whether using in a cluster environment or not, it won't hurt to have the distributable tag. That way if you do cluster later, you don't have to worry about it. The best place for this is immediately after the display-name tag.

  <distributable/>

If planning on using the built-in export capability in the data grids, you need to add this mapping.

  <servlet>
    <description></description>
    <display-name>Export</display-name>
    <servlet-name>Export</servlet-name>
    <servlet-class>com.roth.servlet.ExportServlet</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>Export</servlet-name>
    <url-pattern>/Export/*</url-pattern>
  </servlet-mapping>

Security. This is important. Roth uses form authentication. This part goes at the bottom of the file before the web-app end tag.

  <error-page>
    <location>/error.jsp</location>
  </error-page>
  <login-config>
    <auth-method>FORM</auth-method>
    <form-login-config>
      <form-login-page>/login.jsp</form-login-page>
      <form-error-page>/login.jsp?error=true</form-error-page>
    </form-login-config>
  </login-config>