Run page (Project Properties dialog box)
This dialog box is also called the Runtime Properties dialog box.
The Run page of the Project Properties dialog box lets you set parameters to pass to your application, applet, JavaServer Page, or Enterprise JavaBean at runtime. Available features vary by JBuilder edition.
There are several ways to display this page:
- Choose Project|Project Properties, then click the Run tab.
- Choose Run|Configurations, then click New or Edit.
When you display this page from the Runtime Configurations dialog box, the Configuration Name field is displayed at the top of the page.
(The Runtime Configurations dialog box is a feature of JBuilder Professional and Enterprise.)
- When adding a new configuration, enter the name of the new configuration in the Configuration Name field.
- When editing an existing configuration, the name of the configuration being edited is displayed.
Application
Main Class
The name of the class to run. Click the ellipsis button to display the Select Main Class For Project dialog box, where you choose a class to run.
The selected class must have a method named main().
When you select a class in your project that has a main() method and run it, this class is automatically set as process to run, and all of its saved settings are used.
VM Parameters
Parameters to pass to the Java Virtual Machine (VM) compiler. For more information on the Java VM compiler and the options you can pass to it, see
"Basic Tools: java - The launcher for Java technology applications"
at http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html.
Application Parameters
Parameters to pass to the application. These are command-line arguments and are passed as strings.
Compile Before Running
Compiles the selected class before running it.
Compile Before Debugging
Compiles the selected class before debugging it.
Applet
Main Class
The name of the applet main class to run. Click the ellipsis button to display the Select Main Class For Project dialog box, where you choose the main class to run.
The selected class must contain an init()
method.
The selected class file must be called by an HTML file containing an APPLET
tag that specifies the name of the runnable applet class.
The HTML file's CODE
attribute must contain the fully qualified class name. If the class file is not located in the same directory as the HTML file, the CODEBASE
attribute must specify the location of the class file in relation to the HTML file.
Note: When this option is selected, choosing Run|Run Project runs the applet in JBuilder's applet viewer, AppletTestbed.
HTML File
The name of the HTML file containing the APPLET
tag. Click the ellipsis button to display the Choose HTML File To Run dialog box, where you choose the HTML file with the APPLET
tag. The HTML file's CODE
attribute must contain the fully qualified class name. If the class file is not located in the same directory as the HTML file, the CODEBASE
attribute must specify the location of the class file in relation to the HTML file.
Note: When this option is selected, choosing Run|Run Project runs the applet in Sun's appletviewer.
Java VM Parameters
Parameters to pass to the Java Virtual Machine (VM) compiler. For more information on the Java VM compiler and the options you can pass to it, see
"Basic Tools: java - The launcher for Java technology applications"
at http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html.
Width
The initial width of the AppletViewer. This is a required field.
Height
The initial height of the AppletViewer. This is a required field.
Applet Parameters
Optional parameters to pass to the applet. Examples of optional parameters are CODEBASE
, ARCHIVE
, NAME
, HSPACE
, VSPACE
and PARAM
.
Add
Adds a parameter and value to the Applet Parameters list.
To set an applet parameter, click the Add button. Enter the name of the parameter in the Parameter column. Enter the value in the Value column.
Remove
Removes the selected parameter and value from the Applet Parameters list.
Compile Before Running
Compiles the selected class before running it.
Compile Before Debugging
Compiles the selected class before debugging it.
JSP/Servlet
This page is a feature of JBuilder Professional Enterprise.
Set the options on this page to select the JSP or servlet file to run, and to set properties for the Web server. You can also run these files directly by right-clicking on the file and selecting Web Run.
Start File/Class
You must specify an HTML file (JSP, SHTML, HTML HTM) or a servlet class, a class that extends javax.servlet,http.HttpServlet.
VM Parameters
Extra VM parameters for the Web server. The web server setup should provide any required VM parameters to start the web server. For example, if you want to develop with the classic VM, you can specify -classic.
Query String
Enter user parameters here. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2.
Context Parameters tab
Sets optional context parameters to pass to the JSP or servlet. Context parameters are accessible from all components (servlets and JSPs) in a given context, or application.
Add button
Adds a parameter and value to the Parameters list.
To set a parameter, click the Add button. Enter the name of the parameter in the Parameter column. Enter the value in the Value column.
Remove button
Removes the selected parameter and value from the Applet Parameters list.
Server Options tab
Sets server options.
Server
Select a Web server. By default, JBuilder provides Tomcat 3.1 for running JSPs and servlets. Other web servers may be configured to work with JBuilder. This support can be provided by the web server vendor, a third party, or you can write your own through JBuilder OpenTools API.
Setup button
Click the Setup button to display the Setup dialog box, where you configure the web server. By default, this is Tomcat 3.1.
Host Name
The name of the remote computer you are connecting to. localHost is the default. You may need to check the network settings on the remote computer to find the host name. Some systems may require an IP address.
Port Number
The port number for the remote computer you are communicating with. Use the default port number, 8080.
Change this value only if the default value is in use.
Search For Unused Port
If checked, JBuilder tries to find a port that is not allocated. It is useful to select this option when you are running more than one JSP, as otherwise you might get a message that the port is busy. It is also useful to check this option in the event that a user problem brings the Web server down. With this option selected, you will be protected if the Web server is not shut down properly.
Document Base
The directory that is the root of the Web server. All files and URLs that are referenced in the JSP are found using this directory as the relative starting point.
Context Path
The name of the path where the web application is located. This path is used when you select the Web Run command. The name must be a path, and must start with a slash. You can use this path in the URLs inside your application - you won't need to change them when you deploy.
IDE Options tab
Selects IDE options.
Echo HTTP Commands To Standard Output
If checked, HTTP commands such as get
and put
are echoed to an output box. This is useful when debugging a JSP.
Keep Generated Files
If checked, compiled java files are kept, if unchecked, they are deleted. Leave this option on when debugging.
Disable Tracing To Server Classes
If this option is checked, the debugger will not trace into server-side classes.
Use Integrated Browser (Web View)
Uncheck this option when using an external Web browser so that the Web View page does not appear. Saves some overhead, memory, and stops the switching to the Web View page.
EJB page (Project Properties dialog box)
This is a feature of JBuilder Professional and Enterprise.
Use this page to prepare running your enterprise bean using the application server of your choice. JBuilder suggests parameters that will be suitable for most of your needs, but you can make the changes you want.
Application Server
Displays the name of the target application server (the application server the enterprise bean will run on.) Specify the target application server using the Enterprise page of the Project Properties dialog box.
VM Parameters
Specify any parameters you want to pass to the Java Virtual Machine (VM) compiler.
Application Server Parameters
Specify the parameters you want to pass to the target application server.
Application Server Instance Name
The name of the application server instance that will be running your enterprise bean.
EJB Jars
The fully-qualified names of the JAR files that will be created and deployed to the specified application server instance.