docs/org.eclipse.jst.j2ee.doc.user/topics/twebfragproj.html - gerrit/jeetools/webtools.javaee - Git at Google

 <?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html lang="en-us" xml:lang="en-us">
 <head>
 <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
 <meta name="copyright" content="Copyright (c) 2000, 2009 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/. Contributors: IBM Corporation - initial API and implementation" />
 <meta name="DC.rights.owner" content="(C) Copyright 2000, 2009" />
 <meta content="public" name="security" />
 <meta content="index,follow" name="Robots" />
 <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
 <meta content="task" name="DC.Type" />
 <meta name="DC.Title" content="Creating Web fragment projects" />
 <meta name="abstract" content="You can use the Web fragment project wizard to create Web fragment projects in your workspace." />
 <meta name="description" content="You can use the Web fragment project wizard to create Web fragment projects in your workspace." />
 <meta content="Java EE, Web fragment projects, creating" name="DC.subject" />
 <meta content="Java EE, Web fragment projects, creating" name="keywords" />
 <meta scheme="URI" name="DC.Relation" content="../topics/ph-projects.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="webfragmentproj" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
 <link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
 <title>Creating Web fragment projects</title>
 </head>
 <body id="webfragmentproj"><a name="webfragmentproj"><!-- --></a>


 <h1 class="topictitle1">Creating Web fragment projects</h1>


 <div><p>You can use the Web fragment project wizard to create Web
 fragment projects in your workspace.</p>

 <div class="p"><p>A web fragment is a logical partitioning of the web application
 in such a way that the frameworks being used within the web application
 can define all the artifacts without requiring you to edit or add
 information in the web.xml. It can include almost all the same elements
 that the web.xml descriptor uses, with these requirements:</p>
 <ul>
 <li>The top level element for the descriptor must be web-fragment</li>

 <li>The corresponding descriptor file must be called web-fragment.xml</li>

 </ul>
 <p>If a framework is packaged as a jar file and has metadata
 information in the form of deployment descriptor, then the web-fragment.xml
 descriptor must be in the META-INF/ directory of the jar file.</p>
 <p>A
 web fragment is a mechanism for either defining or extending the deployment
 descriptor of a web application by means of pluggable library jars
 that contain both the incremental deployment information (in the web-fragment.xml)
 and potentially any related or relevant classes.  The web fragment
 is also packaged as a library (jar), with the web-fragment.xml in
 the META-INF directory. Consequently, the web fragment project is
 essentially a Utility project, with the addition of a web fragment
 facet to it. The web fragment facet enables you to add relevant context-sensitive
 functionality to the fragment project.</p>
 </div>


 <ol>
 <li class="stepexpand"><span>In the Java EE perspective,
 select <span class="menucascade"><span class="uicontrol">File</span> &gt; <span class="uicontrol">New</span>
  &gt; <span class="uicontrol">Web Fragment Project</span></span>. Alternatively,
 right-click the Enterprise Explorer context menu, and select <span class="menucascade">
 <span class="uicontrol">New</span> &gt; <span class="uicontrol">Web Fragment Project</span>
 </span>. The Web fragment wizard opens.</span></li>

 <li class="stepexpand"><span>In the <span class="uicontrol">Name</span> field, type a name for
 the Web fragment project. To change the default <span class="uicontrol">Project
 contents</span>, click the <span class="uicontrol">Browse</span> button
 to select a new location.</span> <p>If you specify a non-default
 project location that is already being used by another project, the
 project creation fails.</p>
 </li>

 <li class="stepexpand"><span>The <span class="uicontrol">Target runtime</span> field is pre-populated
 with the selection from the enterprise project.</span></li>

 <li class="stepexpand"><strong>Optional: </strong><span>Select a pre-defined project configuration
 from the <span class="uicontrol">Configurations</span> drop-down list.</span>
 </li>

 <li class="stepexpand"><strong>Optional: </strong><span>If you want to modify the configuration
 details, click <span class="uicontrol">modify</span>:</span></li>

 <li class="stepexpand"><strong>Optional: </strong><span>Select one or more project facets
 from the <span class="uicontrol">Project Facets</span> list. To specify server
 runtime environments, click <span class="uicontrol">Show Runtimes</span> and
 select one or more runtimes. After making your selections, you can
 save your custom configuration by clicking <span class="uicontrol">Save</span>.</span>
 </li>

 <li class="stepexpand"><strong>Optional: </strong><span>Select the <span class="uicontrol">Add project
 to Dynamic Web project</span> check box to add the new module
 to an enterprise module (WAR) project.</span> Type a new project
 name or select an existing enterprise module project from the drop-down
 list in the <span class="uicontrol">Dynamic Web project name</span> combination
 box. Or, click <span class="uicontrol">New</span> to launch the New EAR module
 Project wizard.</li>

 <li class="stepexpand"><span>Select <span class="uicontrol">Add project to working sets</span> to
 add the Web fragment project to an existing working set, or click <span class="uicontrol">Select</span> to
 locate a working set, and click <span class="uicontrol">Next</span>.</span>
 </li>

 <li class="stepexpand"><span>On the Configure project for building a Java application page, on the <span class="uicontrol">Source
 folders on build path</span> field, click <span class="uicontrol">Add Folder...</span> to
 add folders for your source on the build path, or accept the default
 value (src).</span></li>

 <li class="stepexpand"><span>In the <span class="uicontrol">Default output Folder:</span> field,
 specify a folder for your output files or accept the default value
 (bin), and click <span class="uicontrol">Finish</span>.</span></li>

 <li class="stepexpand"><span>In Package Explorer view, you see the resulting Web Fragment
 project folders:</span> <br /><img src="../images/webfrag.jpg" alt="Web fragment folders" /><br />
 </li>

 </ol>

 </div>

 <div>
 <div class="familylinks">
 <div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-projects.html" title="The workbench can work with many different types of projects. The following topics cover creating and managing some of the types of projects related to J2EE development.">Working with projects</a></div>
 </div>
 </div>

 </body>
 </html>
	<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	<html lang="en-us" xml:lang="en-us">
	<head>
	<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
	<meta name="copyright" content="Copyright (c) 2000, 2009 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/. Contributors: IBM Corporation - initial API and implementation" />
	<meta name="DC.rights.owner" content="(C) Copyright 2000, 2009" />
	<meta content="public" name="security" />
	<meta content="index,follow" name="Robots" />
	<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
	<meta content="task" name="DC.Type" />
	<meta name="DC.Title" content="Creating Web fragment projects" />
	<meta name="abstract" content="You can use the Web fragment project wizard to create Web fragment projects in your workspace." />
	<meta name="description" content="You can use the Web fragment project wizard to create Web fragment projects in your workspace." />
	<meta content="Java EE, Web fragment projects, creating" name="DC.subject" />
	<meta content="Java EE, Web fragment projects, creating" name="keywords" />
	<meta scheme="URI" name="DC.Relation" content="../topics/ph-projects.html" />
	<meta content="XHTML" name="DC.Format" />
	<meta content="webfragmentproj" name="DC.Identifier" />
	<meta content="en-us" name="DC.Language" />
	<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
	<title>Creating Web fragment projects</title>
	</head>
	<body id="webfragmentproj"><a name="webfragmentproj"><!-- --></a>


	<h1 class="topictitle1">Creating Web fragment projects</h1>



	<div><p>You can use the Web fragment project wizard to create Web
	fragment projects in your workspace.</p>

	<div class="p"><p>A web fragment is a logical partitioning of the web application
	in such a way that the frameworks being used within the web application
	can define all the artifacts without requiring you to edit or add
	information in the web.xml. It can include almost all the same elements
	that the web.xml descriptor uses, with these requirements:</p>
	<ul>
	<li>The top level element for the descriptor must be web-fragment</li>

	<li>The corresponding descriptor file must be called web-fragment.xml</li>

	</ul>
	<p>If a framework is packaged as a jar file and has metadata
	information in the form of deployment descriptor, then the web-fragment.xml
	descriptor must be in the META-INF/ directory of the jar file.</p>
	<p>A
	web fragment is a mechanism for either defining or extending the deployment
	descriptor of a web application by means of pluggable library jars
	that contain both the incremental deployment information (in the web-fragment.xml)
	and potentially any related or relevant classes. The web fragment
	is also packaged as a library (jar), with the web-fragment.xml in
	the META-INF directory. Consequently, the web fragment project is
	essentially a Utility project, with the addition of a web fragment
	facet to it. The web fragment facet enables you to add relevant context-sensitive
	functionality to the fragment project.</p>
	</div>


	<ol>
	<li class="stepexpand"><span>In the Java EE perspective,
	select <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">New</span>
	> <span class="uicontrol">Web Fragment Project</span></span>. Alternatively,
	right-click the Enterprise Explorer context menu, and select <span class="menucascade">
	<span class="uicontrol">New</span> > <span class="uicontrol">Web Fragment Project</span>
	</span>. The Web fragment wizard opens.</span></li>

	<li class="stepexpand"><span>In the <span class="uicontrol">Name</span> field, type a name for
	the Web fragment project. To change the default <span class="uicontrol">Project
	contents</span>, click the <span class="uicontrol">Browse</span> button
	to select a new location.</span> <p>If you specify a non-default
	project location that is already being used by another project, the
	project creation fails.</p>
	</li>

	<li class="stepexpand"><span>The <span class="uicontrol">Target runtime</span> field is pre-populated
	with the selection from the enterprise project.</span></li>

	<li class="stepexpand"><strong>Optional: </strong><span>Select a pre-defined project configuration
	from the <span class="uicontrol">Configurations</span> drop-down list.</span>
	</li>

	<li class="stepexpand"><strong>Optional: </strong><span>If you want to modify the configuration
	details, click <span class="uicontrol">modify</span>:</span></li>

	<li class="stepexpand"><strong>Optional: </strong><span>Select one or more project facets
	from the <span class="uicontrol">Project Facets</span> list. To specify server
	runtime environments, click <span class="uicontrol">Show Runtimes</span> and
	select one or more runtimes. After making your selections, you can
	save your custom configuration by clicking <span class="uicontrol">Save</span>.</span>
	</li>

	<li class="stepexpand"><strong>Optional: </strong><span>Select the <span class="uicontrol">Add project
	to Dynamic Web project</span> check box to add the new module
	to an enterprise module (WAR) project.</span> Type a new project
	name or select an existing enterprise module project from the drop-down
	list in the <span class="uicontrol">Dynamic Web project name</span> combination
	box. Or, click <span class="uicontrol">New</span> to launch the New EAR module
	Project wizard.</li>

	<li class="stepexpand"><span>Select <span class="uicontrol">Add project to working sets</span> to
	add the Web fragment project to an existing working set, or click <span class="uicontrol">Select</span> to
	locate a working set, and click <span class="uicontrol">Next</span>.</span>
	</li>

	<li class="stepexpand"><span>On the Configure project for building a Java application page, on the <span class="uicontrol">Source
	folders on build path</span> field, click <span class="uicontrol">Add Folder...</span> to
	add folders for your source on the build path, or accept the default
	value (src).</span></li>

	<li class="stepexpand"><span>In the <span class="uicontrol">Default output Folder:</span> field,
	specify a folder for your output files or accept the default value
	(bin), and click <span class="uicontrol">Finish</span>.</span></li>

	<li class="stepexpand"><span>In Package Explorer view, you see the resulting Web Fragment
	project folders:</span> <br /><img src="../images/webfrag.jpg" alt="Web fragment folders" /><br />
	</li>

	</ol>

	</div>

	<div>
	<div class="familylinks">
	<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-projects.html" title="The workbench can work with many different types of projects. The following topics cover creating and managing some of the types of projects related to J2EE development.">Working with projects</a></div>
	</div>
	</div>

	</body>
	</html>