Using Web Fragments with Web Projects

This tutorial shows you the mechanism for creating a web fragment project with an associated web project. You are also provided with example projects to examine. In this tutorial, you will learn how to:

  • Create a web fragment and associated web project
  • Deploy and test a sample web project that includes a web fragment

This feature is available in MyEclipse.

1. Create a Web Fragment Project

The web fragment you create will be included in a new dynamic Web application, which you will create along with the Web Fragment project.

  1. Select File>New>Project, select Web Fragment Project, and click Next.
  2. Type webFrag into the Project name field.
  3. Accept the default target runtime, or select the runtime for your deployment server.
  4. Select the Add project to a Dynamic Web project checkbox, and click New to create a host Web project.

    webfragnew
    Creating a new Web Fragment project

  5. Type webProj in the Name field, and click Finish to create the Web project.

  6. Click Finish to complete the Web Fragment project.

    FieldDescription
    Project nameThe project’s name. Must be a valid Eclipse Java project name. 
    LocationCheck the checkbox to specify a custom file-system location for the new project and its resources.
    JavaEE versionSpecifies the JavaEE specification compliance level. Please ensure that you select the proper specification level for the JavaEE features your application requires and that your target deployment application server(s) support this specification level. Check with your application server vendor for information regarding Java EE specification level compliance.
    Add Maven supportEnabling this option includes Maven project management support to your project. See Using Maven in MyEclipse for more information.
    Target RuntimeA run time is selected by default based on your chosen JavaEE version. A runtime must be selected for various containers (Spring, JPA, Struts, etc.) to appear on your project’s build path. You can change the runtime on the Runtime tab of the Project Properties> Project Facets page.
    Dynamic Web ProjectAllows you to add the web fragment to an existing Web project or create a new Web project.

Completing the wizard creates and configures the webFrag Web Fragment project as well as the new Web project. The image below depicts the structure of the new project.

Notice the JRE System Library folder in both projects. These are a libraries of JavaEE API Jars provided by MyEclipse to your project for compilation and code completion support. These API JAR files are placed only in the project’s build path.

Note: No JavaEE JAR files or other resources are physically copied into your project.

webfragexplorer
Web Fragment and associated Web project

If you create a Web Fragment project to be used with existing Web projects, you must define the dependent Web Fragment project through the existing Web project’s Deployment Assembly property.

  • To access Deployment Assembly properties, right-click the target Web project, and select Properties>Deployment>Deployment Assembly This menu option was updated in MyEclipse 2017. For prior versions, click here. , and click Add. See Configuring a Dependent Java Project and MyEclipse Deployment Assembly for more details.

Note: If you specify a dynamic Web project when creating a Web Fragment project, the dependency is automatically included in the deployment assembly.

2. Deploy a Web Project

When deploying a Web project that references a Web Fragment project, you deploy the Web project. Because the web fragment is referenced, it is deployed with the hosting Web project. In this section, you can try out the deployment of a sample Web project that references a web fragment.

  1. Download webfragment.zip, and import the existing project into MyEclipse. You will have two projects – WebFragmentHost and WebFragment.
  2. Right-click the MyEclipse Tomcat server in the Servers view, and select Add/Remove Deployments.

    Note: This project does not run on Tomcat 6.

  3. Select the WebFragmentHost project in the Available column, click Add, and then click Finish.

    webfradadddeployment
    Deploying to the MyEclipse Tomcat Server

This deploys the WebFragmentHost project to the MyEclipse Tomcat work area in exploded WAR format. The context-root under which the project is deployed is /WebFragmentHost and is accessible at http://localhost-name:8080/WebFragmentHost. Recall that the context-root is a user-defined Web project property. Access web properties by right-clicking the project, selecting Properties>Project Facets>Web.

3. Test the Application

  1. Right-click WebFragmentHost, and select Run As>MyEclipse Server Application.
  2. Select the MyEclipse Tomcat server, and click Finish. The WelcomeServlet.java file from the web fragment displays a page in the browser.


    Viewing the Web Fragment Host project in the web browser