Under normal circumstances, Workshop for WebLogic builds your files automatically and you can deploy at any time. Before you can deploy your application, you must have a successful build completed.
The following topic explains the basic concepts of deploying and debugging Workshop for WebLogic applications to WebLogic Server running in development mode.
Weblogic Server can be started in one of two modes: development or production mode. (When you start the Workshop for WebLogic server domain using the startup script provided, it runs in development mode.) In development mode, WebLogic Server behaves in ways that make it easier to iteratively develop and test an application: for example, it automatically deploys the current application in an exploded format and certain security restrictions on deployment are relaxed.
Deployment consists of three steps:
These three steps are normally done seamlessly. An EAR file is not generated for deployment to a single test server. The table below shows how different applications and application components are deployed both for development and for production.
When you deploy, all open projects associated with the server are deployed. You can use the Project > Close Project command to close projects. You can also specify working sets (described in the Eclipse help system in the Workbench User Guide) to control how much gets built and deployed.
However, even though an entire application or group of projects was deployed, only the file/folder that you clicked on (to initiate the deploy) will display its results. For example, if you deploy from a page flow component file, that page flow will run in a new browser tab in the editor area. If you deploy a web service, the test client page for that web service will run in a new tab in the editor area. If the page flow or web service relies on other web services to run correctly, it will still work because all components are actually deployed.
You can also manage the projects that get deployed to the server.
There are two commands that deploy your application:
If you wish to simply publish your files to the server, you can use the Servers view (described below) to publish only. The Servers view also allows you to un-deploy applications from the server.
After you deploy your application, the Servers view is displayed automatically and the results of running your application are displayed in the editor area of the workbench.
If you are running a page flow, the initial JSP page will appear in a tab in the editor area. This tab is a test browser that allows you to run your application.
If you are running a web service, the test client appears in a tab in the editor area. This tab allows you to specify the parameters to an operation and make a request to that operation. The response from the operation is displayed in the same tab.
The Servers view opens automatically when you deploy/run your application. You can also open it manually by clicking Window > Show View > Other, expand Server and click Servers. There are many commands available from the Servers view for managing your server(s), as shown in the diagram below.
Servers view is a standard Eclipse feature, and is described in detail in the Eclipse help system which you can view by clicking Help > Help Contents and choosing Web Application Development Guide from the Contents pane.
The Eclipse platform provides standard debugging tools for your Java files, including setting breakpoints and displaying the values of variables. To set a breakpoint, from the editor view, right click in the marker bar (the gray bar at the left of the text) on the line where you wish to set the breakpoint and choose Toggle Breakpoint from the popup menu.
Once a breakpoint(s) is set, when you run the application, you will be prompted to enter Debug perspective and you can use the Step Into, Step Over and other commands available from the Debug view to step through your application. The Breakpoints and Variables views also allow you to monitor your breakpoints and variables as you debug.
The debugging commands are described in more detail in the Java Development User Guide section of the help system.
The following procedure explains how to deploy Workshop for WebLogic applications to WebLogic Server running in production mode. This task is divided into three steps:
Before you deploy a Workshop for WebLogic application to WebLogic Server, you must first ensure that the server domain has the resources expected by the application to be deployed. For example, Apache Beehive NetUI and Controls framework-related libraries must be present if the application uses these frameworks and the server must have the appropriate JMS queues configured if the application contains message buffering, reliable messaging, and JMS transport.
General purpose server resources for Workshop for WebLogic applications are provided through the WebLogic Server Configuration Wizard, including support for Apache Beehive NetUI and Controls, JMS, Pointbase, Java Server Pages, Java Server Faces, and Struts. See the instructions for creating a new Workshop for WebLogic-enabled server or adding Workshop for WebLogic resources to an existing server.
The configuration wizard is not guaranteed to provide sufficient resources for every application. For example, if your application uses JMS queues other than the default Workshop for WebLogic queues, you will need to manually configure the server to included those non-default JMS queues. For detailed instructions on configuring JMS queues for WebLogic Server see Configuring Basic JMS System Resources in the WebLogic Server documentation. Similarly, if your application uses a datasource other than the default Pointbase datasource, you will need to manually configure the server domain to include that datasource. For more information on configuring datasources see Configuring a Database Service in the WebLogic Server documentation.
To package your application as an EAR file, select File > Export > EAR file. In the EAR Application field select the name of the EAR project you wish to archive. The EAR archive produced will contain all of the projects that are already components of the selected EAR.
You can also export the build process for projects to an Ant script. For more information see Creating Custom Ant Build Files for an Application.
Open the WebLogic Server console for the target server running in production mode.
If you click the plus sign in front of the deployed EAR, a list of the application's deployed modules (EJBs and web applications) will appear.
For more information about deploying an application to a server in production mode, see Deploying Applications on BEA WebLogic Server 10.0 in the WebLogic Server documentation.
For information on updating an already deployed application, see Updating Applications in a Production Environment.