Oracle WebLogic Server Support: Configuring a Project to Use WebLogic SCA

This document describes the following:


1. Configuring a Project to Use WebLogic SCA

OEPE provides support for WebLogic SCA container. You use it to populate the Spring context file and bundle as part of any regular Java EE deployment bundles, such as EAR or WAR.

Note that prior to using OEPE support for WebLogic SCA in your Eclipse project, you need to configure Oracle WebLogic Server 11g Release 1 Patch Set 1 at localhost.


1.1 Performing Configuration Steps

You enable your project for WebLogic SCA by adding a facet provided by OEPE, as follows:
  1. Create a dynamic Web project by right-clicking the Project Explorer and selecting New > Dynamic Web Project from the drop-down menu. This opens the New Dynamic Web Project dialog, as Figure 1 shows. Complete the dialog as follows:
    • specify the name for your project;
    • select Add project to an EAR and provide a new EAR name;
    • set the target runtime to Oracle WebLogic Server 11gR1 PatchSet 1;
    • set the dynamic Web module version;




    • Figure 1.
      New Dynamic Web Project Dialog


    • click Modify on the Configuration field of the New Dynamic Web Project dialog to open the Project Facets dialog shown in Figure 2. Define the project facets, as follows:
      • ensure that WebLogic Web App Extensions facet is selected;
      • select Spring facet with version 2.0 or 2.5;
      • select WebLogic SCA facet, and then click OK to close the Project Facets dialog.




      • Figure 2.
        Setting WebLogic SCA Facet



  2. Click Next on the New Dynamic Web Project dialog.

  3. You may accept or modify default settings on the next New Dynamic Web Project > Web Module screen, and then click Next. This opens the New Dynamic Web Project > Spring screen, as Figure 3 shows.



    Figure 3.
    Specifying Spring Library


  4. If you do not see Spring Framework 2.5.6 listed, click Download Library. On the Download Library dialog shown in Figure 4, select Spring Framework 2.5.6 library provided by Oracle, and then click Next. Accept the terms of the Apache License, and then click Finish.



    Figure 4.
    Downloading Spring Library


    Note that, if your machine is located inside of a network which requires a proxy to access outside resource such as the Internet, the download may fail due to the fact that Eclipse IDE includes a Web browser to let you access the Internet from within the IDE. In this case, reconfigure your Eclipse IDE proxy settings using Window > Preferences > General > Network Connections, and try again.

  5. Upon the completion of the Spring library download, make sure the Spring Framework 2.5.6 library is selected on the New Dynamic Web Project > Spring dialog. You may choose to select Create a Spring bean definitions file to generated the applicationContext.xml file and trigger the update of web.xml file to load the Spring bean configuration file, and then click Next.

  6. Click Finish on the New Dynamic Web Project > WebLogic SCA screen that Figure 5 shows to complete your configuration.



    Figure 5.
    Configuring Project to Use WebLogic SCA


Upon the completion of the configuration, OEPE adds WebLogic SCA shared library and Spring library to your project, as well as creates the spring-context.xml file in your project's META-INF/jsca directory, as Figure 6 shows.



Figure 6.
Project Configured to Use WebLogic SCA


You can open the spring-context.xml file, shown in Figure 7, either in source view by double-clicking the file name in the Project Explorer, or in graphical view by right-clicking the file name and selecting Open Graph from the drop-down menu.



Figure 7.
spring-context.xml File


You use the spring-context.xml file to define new beans, specify services, bindings, and so on, as Figure 8 shows.



Figure 8.
Defining Beans, Services, and Bindings in spring-context.xml File



1.2 Deploying WebLogic SCA Application

You use Oracle WebLogic Server 11g Release 1 Patch Set 1 to deploy your dynamic Web project configured for WebLogic SCA, as follows:
  • Start an instance of Oracle WebLogic Server 11g Release 1 Patch Set 1 at localhost.

  • Open the server configuration (Overview) page by double-clicking on the server name in the Servers view. Ensure that the information is correct. Notice that the domain area does not contain your project's name.

  • Add your configured project's EAR to the server, as Figure 9 shows. To do so, right-click Oracle WebLogic Server 11gR1 PatchSet 1 at localhost in Servers view, select Add and Remove Projects from the drop-down menu, find your the EAR in the list of projects, and then click Add followed by Finish on the Add and Remove Projects dialog.



    Figure 9.
    Adding Project to the Server


    Now the server configuration page displays the project and its EAR under the base_domain, as Figure 10 shows.



    Figure 10.
    Server Configuration Page


    The server console displays the deployment logging information, as Figure 11 shows.



    Figure 11.
    Server Logging Information


You can run your services by right-clicking a sca:service node listed under beans in the spring-context.xml file in the Project Explorer, and then selecting Run As > Run On Server from the drop-down menu, as Figure 12 shows.



Figure 12.
Running the Services


Upon completion of the Run On Server dialogs, a WSDL file, which you can use with other OEPE features, will be created by WebLogic SCA deployment process and will be loaded in a browser.


2. Related Information

Generating Spring Artifacts

Generating a Web Service for Spring Service Bean

Generating a Web Service From a WSDL File