diff options
75 files changed, 3780 insertions, 400 deletions
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/build.properties b/docs/org.eclipse.jst.j2ee.doc.user/build.properties index 8c2a8496b..e0147fd98 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/build.properties +++ b/docs/org.eclipse.jst.j2ee.doc.user/build.properties @@ -1,5 +1,6 @@ bin.includes = images/,\ jst_j2ee_toc.xml,\ + jst_j2ee_ant.xml,\ topics/,\ plugin.xml,\ plugin.properties,\ diff --git a/docs/org.eclipse.jst.j2ee.doc.user/images/AddRelationship.gif b/docs/org.eclipse.jst.j2ee.doc.user/images/AddRelationship.gif Binary files differdeleted file mode 100644 index a56a758a4..000000000 --- a/docs/org.eclipse.jst.j2ee.doc.user/images/AddRelationship.gif +++ /dev/null diff --git a/docs/org.eclipse.jst.j2ee.doc.user/images/ProjectExplorer.gif b/docs/org.eclipse.jst.j2ee.doc.user/images/ProjectExplorer.gif Binary files differnew file mode 100644 index 000000000..0877107ed --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/images/ProjectExplorer.gif diff --git a/docs/org.eclipse.jst.j2ee.doc.user/images/Relationships.gif b/docs/org.eclipse.jst.j2ee.doc.user/images/Relationships.gif Binary files differdeleted file mode 100644 index a9f52eb04..000000000 --- a/docs/org.eclipse.jst.j2ee.doc.user/images/Relationships.gif +++ /dev/null diff --git a/docs/org.eclipse.jst.j2ee.doc.user/images/n5rpdcst.gif b/docs/org.eclipse.jst.j2ee.doc.user/images/n5rpdcst.gif Binary files differdeleted file mode 100644 index 68be18cb6..000000000 --- a/docs/org.eclipse.jst.j2ee.doc.user/images/n5rpdcst.gif +++ /dev/null diff --git a/docs/org.eclipse.jst.j2ee.doc.user/images/ycwin.gif b/docs/org.eclipse.jst.j2ee.doc.user/images/ycwin.gif Binary files differdeleted file mode 100644 index 895f9ca06..000000000 --- a/docs/org.eclipse.jst.j2ee.doc.user/images/ycwin.gif +++ /dev/null diff --git a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_ant.xml b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_ant.xml new file mode 100644 index 000000000..3adb41d6b --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_ant.xml @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="utf-8"?> +<?NLS TYPE="org.eclipse.help.toc"?> +<toc label="Ant" topic="topics/tjant.html"> + <topic label="Working with Ant" href="topics/tjant.html"> + <topic label="Ant support" href="topics/cjant.html"/> + <topic label="Extended Ant Support - overview" href="topics/tanthome.html"/> + <topic label="Running Ant in a headless workspace" href="topics/tjantheadless.html"/> + <topic label="Upgrading Ant" href="topics/tjantupgrade.html"/> + <topic label="General Ant tasks" href="topics/ph-antgeneral.html"> + <topic label="captureBuildMessages" href="topics/tantcapturebuildmessages.html"/> + <topic label="compileWorkspace" href="topics/tantcompilew.html"/> + <topic label="getJavacErrorCount" href="topics/tantgetj.html"/> + <topic label="getProjectData" href="topics/tantgetp.html"/> + <topic label="projectBuild" href="topics/tantproj.html"/> + <topic label="projectGetErrors" href="topics/tantprojectgeterrors.html"/> + <topic label="projectImport" href="topics/tantprojectimport.html"/> + <topic label="projectSetBuild" href="topics/tantprojectsetbuild.html"/> + <topic label="projectSetImport" href="topics/tantprojectsetimport.html"/> + <topic label="setDebugInfo" href="topics/tantsetd.html"/> + <topic label="workspaceBuild" href="topics/tantworkspacebuild.html"/> + <topic label="workspaceGetErrors" href="topics/tantworkspacegeterrors.html"/> + <topic label="workspacePreferenceFile" href="topics/tantworkspacepreferencefile.html"/> + <topic label="workspacePreferenceGet" href="topics/tantworkspacepreferenceget.html"/> + <topic label="workspacePreferenceSet" href="topics/tantworkspacepreferenceset.html"/> + </topic> + <topic label="Ant tasks for J2EE" href="topics/ph-antj2ee.html"> + <topic label="autoAppInstall" href="topics/tantautoappinstall.html"/> + <topic label="AppClientExport" href="topics/tantappc.html"/> + <topic label="EARExport" href="topics/tanteare.html"/> + <topic label="UtilJar" href="topics/tantutil.html"/> + <topic label="WARExport" href="topics/tantware.html"/> + </topic> + <topic label="Ant tasks for EJB-enabled tools" href="topics/ph-antejb.html"> + <topic label="AccessBeanRegeneration" href="topics/tantaxbn.html"/> + <topic label="EJBDeploy" href="topics/tantejbd.html"/> + <topic label="EJBExport" href="topics/tantejbe.html"/> + </topic> + <topic label="Example: Automated Ant build" href="topics/tantexampleautobuild.html"/> + <topic label="Example: Automated Ant deploy" href="topics/tantexampleautodeploy.html"/> + </topic> +</toc>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml index 956439a40..f0a5a5f4d 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml +++ b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml @@ -1,17 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> -<?NLS TYPE="org.eclipse.help.toc"?> -<!-- /******************************************************************************* - * Copyright (c) 2000, 2005 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 - * http://www.eclipse.org/legal/epl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ --> -<toc label="J2EE applications - open source" topic="topics/cjarch.html"> - <topic label="J2EE applications"> +<?NLS TYPE="org.eclipse.help.toc"?> +<toc label="J2EE applications - open source" topic="topics/ph-j2eeapp.html"> + <topic label="J2EE Applications" href="topics/ph-j2eeapp.html"> <topic label="J2EE architecture" href="topics/cjarch.html"/> <topic label="J2EE perspective" href="topics/cjpers.html"/> <topic label="Project Explorer view in the J2EE perspective" href="topics/cjview.html"/> @@ -22,14 +12,15 @@ <topic label="Creating an application client project" href="topics/tjappproj.html"/> <topic label="Creating a connector project" href="topics/tjrar.html"/> <topic label="Specifying target servers for J2EE projects" href="topics/tjtargetserver.html"/> - <topic label="Importing J2EE projects and files" href="topics/ph-importexport.html"> + <topic label="Importing and exporting projects and files" href="topics/ph-importexport.html"> <topic label="Exporting an application client project" href="topics/tjexpapp.html"/> <topic label="Exporting an enterprise application into an EAR file" href="topics/tjexpear.html"/> + <topic label="Exporting connector projects to RAR files" href="topics/tjexprar.html"/> <topic label="Importing an enterprise application EAR file" href="topics/tjimpear.html"/> <topic label="Importing an application client JAR file" href="topics/tjimpapp.html"/> + <topic label="Importing a connector project RAR file" href="topics/tjimprar.html"/> <topic label="Cyclical dependencies between J2EE modules" href="topics/cjcircle.html"/> <topic label="Correcting cyclical dependencies after an EAR is imported" href="topics/tjcircleb.html"/> - </topic> </topic> <topic label="Validating code in enterprise applications" href="topics/tjval.html"> @@ -42,10 +33,11 @@ <topic label="Manually validating code" href="topics/tjvalmanual.html"/> <topic label="Selecting code validators" href="topics/tjvalselect.html"/> </topic> + <link toc="jst_j2ee_ant.xml"/> <topic label="Reference" href="topics/ph-ref.html"> <topic label="J2EE Validators" href="topics/rvalidators.html"/> <topic label="Common validation errors and solutions" href="topics/rvalerr.html"/> - <topic label="Limitations of J2EE development tools" href="topics/rjlimitcurrent.html"/> + <topic label="Limitations of J2EE development tools" href="topics/rjlimitcurrent.html"/> </topic> </topic> </toc>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/org.eclipse.jst.j2ee.doc.userindex.html b/docs/org.eclipse.jst.j2ee.doc.user/org.eclipse.jst.j2ee.doc.userindex.html new file mode 100644 index 000000000..5e26b250a --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/org.eclipse.jst.j2ee.doc.userindex.html @@ -0,0 +1,181 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name="copyright" content="(C) Copyright IBM Corporation 2005" /> +<meta name="security" content="public" /> +<meta name="Robots" content="index,follow" /> +<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 name="DC.Format" content="XHTML" /> +<!-- All rights reserved. Licensed Materials Property of IBM --> +<!-- US Government Users Restricted Rights --> +<!-- Use, duplication or disclosure restricted by --> +<!-- GSA ADP Schedule Contract with IBM Corp. --> +<link rel="stylesheet" type="text/css" href="ibmdita.css" /> +<link rel="stylesheet" type="text/css" href="common.css" /> +<title>Index</title> +</head> +<body> +<h1>Index</h1> +<a name="IDX0_41" href="#IDX1_41">A</a> +<a name="IDX0_42" href="#IDX1_42">B</a> +<a name="IDX0_43" href="#IDX1_43">C</a> +<a name="IDX0_45" href="#IDX1_45">E</a> +<a name="IDX0_4A" href="#IDX1_4A">J</a> +<a name="IDX0_50" href="#IDX1_50">P</a> +<a name="IDX0_52" href="#IDX1_52">R</a> +<a name="IDX0_56" href="#IDX1_56">V</a> +<hr></hr> +<strong><a name="IDX1_41" href="#IDX0_41">A</a></strong> +<ul class="indexlist"> +<li>Ant +<ul class="indexlist"> +<li><a href="topics/cjant.html#cjant">additional information</a> +</li> +<li><a href="topics/cjant.html#cjant">overview</a> +</li> +</ul> +</li> +<li>application client projects +<ul class="indexlist"> +<li><a href="topics/cjappcliproj.html#cjappcliproj">overview</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_42" href="#IDX0_42">B</a></strong> +<ul class="indexlist"> +<li>build validation +<ul class="indexlist"> +<li><a href="topics/tjvalbuild.html#tjvalbuild">enabling</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_43" href="#IDX0_43">C</a></strong> +<ul class="indexlist"> +<li>code validation +<ul class="indexlist"> +<li><a href="topics/tjvalauto.html#tjvalauto">automatic</a> +</li> +<li><a href="topics/tjvaldisable.html#tjvaldisable">disabling validators</a> +</li> +<li><a href="topics/rvalerr.html#rvalerr">errors</a> +</li> +<li><a href="topics/rvalidators.html#rvalidators">J2EE validators</a> +</li> +<li><a href="topics/tjvalmanual.html#tjvalmanual">manual</a> +</li> +<li><a href="topics/tjvalglobalpref.html#tjvalglobalpref">overriding global preferences</a> +</li> +<li><a href="topics/tjval.html#tjval">overview</a> +</li> +<li><a href="topics/tjvalselect.html#tjvalselect">selecting validators</a> +</li> +<li><a href="topics/rvalerr.html#rvalerr">solutions to errors</a> +</li> +</ul> +</li> +<li>connector projects +<ul class="indexlist"> +<li><a href="topics/tjrar.html#tjrar">creating</a> +</li> +<li><a href="topics/tjexprar.html#tjexprar">exporting</a> +</li> +<li><a href="topics/tjimprar.html#tjimprar">importing</a> +</li> +</ul> +</li> +<li>cyclical dependencies +<ul class="indexlist"> +<li><a href="topics/tjcircleb.html#tjcircleb">correcting</a> +</li> +<li><a href="topics/cjcircle.html#cjcircle">overview</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_45" href="#IDX0_45">E</a></strong> +<ul class="indexlist"> +<li>enterprise application projects +<ul class="indexlist"> +<li><a href="topics/cjearproj.html#cjearproj">overview</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_4A" href="#IDX0_4A">J</a></strong> +<ul class="indexlist"> +<li>J2EE development +<ul class="indexlist"> +<li><a href="topics/rjlimitcurrent.html#rjlimitcurrent">limitations</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_50" href="#IDX0_50">P</a></strong> +<ul class="indexlist"> +<li>perspectives +<ul class="indexlist"> +<li><a href="topics/cjpers.html#cjpers">J2EE</a> +</li> +</ul> +</li> +<li>projects +<ul class="indexlist"> +<li><a href="topics/cjappcliproj.html#cjappcliproj">application client</a> +</li> +<li><a href="topics/tjcircleb.html#tjcircleb">correcting cyclical dependencies</a> +</li> +<li><a href="topics/cjcircle.html#cjcircle">cyclical dependencies</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_52" href="#IDX0_52">R</a></strong> +<ul class="indexlist"> +<li>RAR files +<ul class="indexlist"> +<li><a href="topics/tjexprar.html#tjexprar">exporting</a> +</li> +<li><a href="topics/tjimprar.html#tjimprar">importing</a> +</li> +</ul> +</li> +</ul> +<strong><a name="IDX1_56" href="#IDX0_56">V</a></strong> +<ul class="indexlist"> +<li>validation +<ul class="indexlist"> +<li><a href="topics/tjvalauto.html#tjvalauto">automatic</a> +</li> +<li><a href="topics/tjvalbuild.html#tjvalbuild">build validation</a> +</li> +<li><a href="topics/tjvaldisable.html#tjvaldisable">disabling validators</a> +</li> +<li><a href="topics/rvalerr.html#rvalerr">errors</a> +</li> +<li><a href="topics/rvalidators.html#rvalidators">J2EE validators</a> +</li> +<li><a href="topics/tjvalmanual.html#tjvalmanual">manual</a> +</li> +<li><a href="topics/tjvalglobalpref.html#tjvalglobalpref">overriding global preferences</a> +</li> +<li><a href="topics/tjval.html#tjval">overview</a> +</li> +<li><a href="topics/tjvalselect.html#tjvalselect">selecting validators</a> +</li> +<li><a href="topics/rvalerr.html#rvalerr">solutions to errors</a> +</li> +</ul> +</li> +<li>views +<ul class="indexlist"> +<li><a href="topics/cjview.html#cjview">Project Explorer</a> +</li> +</ul> +</li> +</ul> +</body></html> diff --git a/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties b/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties index fd00a97fe..99da49998 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties +++ b/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties @@ -1,5 +1,5 @@ # ============================================================================== # Translation Instruction: section to be translated # ============================================================================== -Plugin.name = J2EE Connector (RAR) project documentation +Plugin.name = JST documentation for J2EE tools Plugin.providerName = Eclipse.org
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/plugin.xml b/docs/org.eclipse.jst.j2ee.doc.user/plugin.xml index 6aff4f644..ee041e1ff 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/plugin.xml +++ b/docs/org.eclipse.jst.j2ee.doc.user/plugin.xml @@ -11,8 +11,13 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<plugin> +<plugin name = "%Plugin.name" + id = "org.eclipse.jst.j2ee.doc.user" + version = "1.0.0" + vendor-name = "%Plugin.providerName"> + <extension point="org.eclipse.help.toc"> <toc file="jst_j2ee_toc.xml"/> + <toc file="jst_j2ee_ant.xml"/> </extension> </plugin>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjant.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjant.html new file mode 100644 index 000000000..5cf1ff342 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjant.html @@ -0,0 +1,70 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Ant support</title> +</head> +<body id="cjant"><a name="cjant"><!-- --></a> +<h1 class="topictitle1">Ant support</h1> +<div><p>This topic provides an overview of the Ant support provided in +the workbench.</p> +<p>Ant is a Java-based build tool that is a project of the Jakarta Apache +project. It is similar to Make, except that instead of using operating system +shell-based commands, it uses Java™ classes to perform its operations. +The build scripts are XML files containing targets and specifying the tasks +(operations) required for each. Ant comes with a large number of built-in +tasks sufficient to perform many common build operations. You can learn about +them in the <a href="http://jakarta.apache.org/ant/manual/index.html" target="_blank">Ant user manual</a> on the Jakarta Apache Web site.</p> +<p>Because Ant is Java-based, it is platform-independent. It is well suited +for building Java applications, but can be used for other build tasks +as well. One of its important features is that you can use Java to +write new Ant tasks to extend production build capabilities. </p> +<p>The com.ibm.etools.j2ee.ant plugin contains the following resources:</p> +<ul><li>A <samp class="codeph">readme.htm</samp> file</li> +<li>An example <samp class="codeph">runAnt.bat</samp> file. Use this file to start a +"headless" workspace and run the Ant build script.</li> +<li>An <samp class="codeph">example.xml</samp> file. This file shows examples of some +of the J2EE tasks included in the plugin.</li> +</ul> +<p>Several sources of Ant information are available from the Jakarta Apache +Ant Project. To learn more about Ant, follow the links below:</p> +<ul><li><a href="http://jakarta.apache.org/ant/manual/index.html" target="_blank">Ant user manual</a></li> +<li><a href="http://jakarta.apache.org/site/mail.html" target="_blank">Ant +user mail list</a></li> +<li><a href="http://marc.theaimsgroup.com/?l=ant-user" target="_blank">Ant +user mail list archives</a></li> +<li><a href="http://www.redbooks.ibm.com/pubs/pdfs/redbooks/sg246134.pdf" target="_blank">WebSphere<sup>®</sup> Version 4.0 Application Development Handbook</a>: +Chapter 9 explains how to use Ant to build a WebSphere application.</li> +<li><a href="http://www.javaworld.com/javaworld/jw-10-2000/jw-1020-ant_p.html" target="_blank">Automate your build process using Java and Ant</a>: JavaWorld™ article</li> +<li><a href="http://www.onjava.com/pub/a/onjava/2001/02/22/open_source.html" target="_blank">Open Source Java: Ant</a>: onjava.com article</li> +</ul> +<p>More information about Ant and how to use it with the workbench can be +found in the following series of articles:</p> +<ul><li><a href="http://www7b.software.ibm.com/wsdd/library/techarticles/0203_searle/searle1.html" target="_blank">Using Ant with WebSphere Studio Application Developer: +Part 1 of 3</a></li> +<li><a href="http://www7b.software.ibm.com/wsdd/library/techarticles/0203_searle/searle2.html" target="_blank">Using Ant with WebSphere Studio Application Developer: +Part 2 of 3</a></li> +<li><a href="http://www7b.software.ibm.com/wsdd/library/techarticles/0203_searle/searle3.html" target="_blank">Using Ant with WebSphere Studio Application Developer: +Part 3 of 3</a></li> +</ul> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjappcliproj.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjappcliproj.html index 564b9f987..745c4ff3c 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjappcliproj.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjappcliproj.html @@ -14,13 +14,13 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Application client projects</title> </head> <body id="cjappcliproj"><a name="cjappcliproj"><!-- --></a> - <h1 class="topictitle1">Application client projects</h1> -<div><p>Application client projects contain the resources needed for application +<div><p> Application client projects contain the resources needed for application client modules. An application client module is used to contain a full-function client Java™ application (non Web-based) that connects to and uses the J2EE resources defined in your server. When you place the client @@ -68,14 +68,17 @@ formats).</p> which contains both Java source code and compiled <samp class="codeph">.class</samp> files, along with all the meta-data files in the <span class="uicontrol">META-INF</span> subfolder.</p> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<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 class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjappproj.html" title="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.">Creating an application client project</a></div> <div><a href="../topics/tjexpapp.html" title="You can export an application client project as a JAR file.">Exporting an application client project</a></div> -<div><a href="../topics/tjimpapp.html">Importing an application client JAR file</a></div> -</div> +<div><a href="../topics/tjimpapp.html" title="Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.">Importing an application client JAR file</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjarch.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjarch.html index d9093e0f6..3f07b53bb 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjarch.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjarch.html @@ -4,6 +4,9 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,14 +17,16 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>J2EE architecture</title> </head> <body id="cjarch"><a name="cjarch"><!-- --></a> - <h1 class="topictitle1">J2EE architecture</h1> <div><p>The Java™ 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.</p> +<p>The Java™ 2 Platform, Enterprise Edition (J2EE) provides a standard for +developing multitier, enterprise services.</p> <p>The economy and technology of today have intensified the need for faster, more efficient, and larger-scale information management solutions. The J2EE specification satisfies these challenges by providing a programming model @@ -31,8 +36,8 @@ with an extensive test suite.</p> <p>J2EE architecture supports component-based development of multi-tier enterprise applications. A J2EE application system typically includes the following tiers:</p> <ul><li><strong>Client tier</strong>: In the client tier, Web components, such as Servlets -and JavaServer Pages (JSPs), or standalone Java applications provide a dynamic interface -to the middle tier.</li> +and JavaServer Pages (JSPs), or standalone Java applications provide a dynamic +interface to the middle tier.</li> <li><strong>Middle tier</strong>: In the server tier, or middle tier, enterprise beans and Web Services encapsulate reusable, distributable business logic for the application. These server-tier components are contained on a J2EE Application @@ -49,17 +54,21 @@ component containers host services that support Web and EJB modules.</p> <p>For more information on J2EE architecture and its implicit technologies, download and read the <a href="http://java.sun.com/j2ee/download.html#platformspec" target="_blank">J2EE 1.4 Specification</a>.</p> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-j2eeapp.html" title="These topics deal with the Java 2 Platform, Enterprise Edition (J2EE).">J2EE Applications</a></div> +</div> +<div class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjearproj.html" title="An enterprise application project contains the hierarchy of resources that are required to deploy a J2EE enterprise application, often referred to as an EAR file.">Enterprise application projects</a></div> <div><a href="../topics/cjappcliproj.html">Application client projects</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjear.html">Creating an enterprise application project</a></div> +<div><a href="../topics/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div> <div><a href="../topics/tjexpear.html" title="Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.">Exporting an enterprise application into an EAR file</a></div> <div><a href="../topics/tjappproj.html" title="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.">Creating an application client project</a></div> <div><a href="../topics/tjexpapp.html" title="You can export an application client project as a JAR file.">Exporting an application client project</a></div> -<div><a href="../topics/tjimpapp.html">Importing an application client JAR file</a></div> -</div> +<div><a href="../topics/tjimpapp.html" title="Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.">Importing an application client JAR file</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjcircle.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjcircle.html index 75f9f0269..174e2caba 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjcircle.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjcircle.html @@ -14,11 +14,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Cyclical dependencies between J2EE modules</title> </head> <body id="cjcircle"><a name="cjcircle"><!-- --></a> - <h1 class="topictitle1">Cyclical dependencies between J2EE modules</h1> <div><p>A cyclical dependency between two or more modules in an enterprise application most commonly occurs when projects are imported from outside WebSphere<sup>®</sup> Studio. @@ -31,9 +31,13 @@ This allows you to have your module dependencies function as a tree instead of a cycle diagram. This practice has the added benefit of producing a better factored and layered application.</p> </div> -<div><div class="reltasks"><strong>Related tasks</strong><br /> -<div><a href="../topics/tjcircleb.html" title="You can resolve cyclical dependencies after an EAR is imported.">Correcting cyclical dependencies after an EAR is imported</a></div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> </div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div> +<div><a href="../topics/tjcircleb.html" title="You can resolve cyclical dependencies after an EAR is imported.">Correcting cyclical dependencies after an EAR is imported</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjearproj.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjearproj.html index c0973fd4e..afc9c6d72 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjearproj.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjearproj.html @@ -4,6 +4,7 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,11 +15,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Enterprise application projects</title> </head> <body id="cjearproj"><a name="cjearproj"><!-- --></a> - <h1 class="topictitle1">Enterprise application projects</h1> <div><p>An enterprise application project contains the hierarchy of resources that are required to deploy a J2EE enterprise application, often referred @@ -28,8 +29,8 @@ other J2EE modules and Java™ projects that are combined to compose an EAR file. These projects can be Web modules, EJB modules, application client modules, connector modules, general utility Java JAR files, and EJB client JAR files. Enterprise application projects created in the workbench include a deployment -descriptor, as well as files that are common to all J2EE modules that are -defined in the deployment descriptor.</p> +descriptor, as well as files that are common to all J2EE modules +that are defined in the deployment descriptor.</p> <p>When a J2EE module project is created, it can be associated with an enterprise application project. The project wizards aid this by allowing you to specify a new or existing enterprise application project. Enterprise application projects @@ -48,7 +49,8 @@ the utility JAR files during assembly and deployment.</p> application project to contain your Web, EJB, and application client modules. The enterprise application project is used to compose an entire application from the various modules. Since no source code is built directly into an enterprise -application, these projects are not Java projects, and are not compiled by the Java builder.</p> +application, these projects are not Java projects, and they are not compiled +by the Java builder.</p> <div class="p">When you create an enterprise application project using the workbench, the following key files are automatically created:<dl><dt class="dlterm">META-INF/application.xml</dt> <dd>This file is the deployment descriptor for the enterprise application, @@ -65,20 +67,23 @@ them manually:<dl><dt class="dlterm">.j2ee</dt> <dd>This is a workbench artifact that includes the product version and J2EE specification level for the project.</dd> <dt class="dlterm">.project</dt> -<dd>This is a workbench artifact, the standard project description -file.</dd> +<dd>This is a workbench artifact, the standard project description file.</dd> <dt class="dlterm">.runtime</dt> <dd>This is a workbench artifact that contains the target server definition.</dd> </dl> </div> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<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 class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjear.html">Creating an enterprise application project</a></div> +<div><a href="../topics/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div> <div><a href="../topics/tjexpear.html" title="Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.">Exporting an enterprise application into an EAR file</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjpers.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjpers.html index 13c01fbf3..4a8f5faaf 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjpers.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjpers.html @@ -14,11 +14,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>J2EE perspective</title> </head> <body id="cjpers"><a name="cjpers"><!-- --></a> - <h1 class="topictitle1">J2EE perspective</h1> <div><p>The J2EE perspective includes workbench views that you can use when developing resources for enterprise applications, EJB modules, Web modules, @@ -70,6 +70,9 @@ and stop each server from this view, and you can launch the test client.</dd> you can insert into appropriate places in your source code.</dd> </dl> </div> -<div></div> -</body> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-j2eeapp.html" title="These topics deal with the Java 2 Platform, Enterprise Edition (J2EE).">J2EE Applications</a></div> +</div> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjview.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjview.html index 260817e3a..4a108172b 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/cjview.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/cjview.html @@ -14,11 +14,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> - <link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Project Explorer view in the J2EE perspective</title> </head> <body id="cjview"><a name="cjview"><!-- --></a> - <h1 class="topictitle1">Project Explorer view in the J2EE perspective</h1> <div><p>While developing J2EE applications in the J2EE perspective, the Project Explorer view is your main view of your J2EE projects and resources.</p> @@ -28,25 +28,18 @@ descriptors, Java™ artifacts, resources, Web services, databases, and dynamic Web project artifacts.<p>You should use this view to work with your J2EE deployment descriptors and their content. You can easily view an enterprise application project and see all of the modules associated with -it. In addition, Java and resource content is provided for each J2EE -module.</p> -<dl><dt class="dlterm">Other Projects</dt> -<dd>Shows any non-J2EE module projects, such as Java projects. These Java projects -can be any of the following types: <ul><li>Utility projects for existing Enterprise Application projects in your -workspace</li> -<li>EJB Client JAR Projects, which include the client interface classes (remote, -home, local, or local home interfaces) for beans in EJB projects</li> -<li>Java projects -that are in your workspace but unrelated to your J2EE development</li> -</ul> -</dd> +it. </p> +<p>The following image shows the Project Explorer view with the <span class="uicontrol">Group +projects by type</span> option selected in the toolbar:<br /><img src="../images/ProjectExplorer.gif" alt="Screen capture of the Project Explorer view" /><br /></p> +<dl><dt class="dlterm">Enterprise Applications</dt> +<dd>Shows a hierarchical model of all enterprise application projects.</dd> <dt class="dlterm">Application Client Projects</dt> <dd>Shows a hierarchical model of all application client modules.</dd> <dt class="dlterm">Connector Projects</dt> <dd>Shows a hierarchical model of all connector modules.</dd> <dt class="dlterm">Dynamic Web Projects</dt> <dd>Shows a hierarchical model of all dynamic Web modules.</dd> -<dt class="dlterm">Ejb Projects</dt> +<dt class="dlterm">EJB Projects</dt> <dd>Shows a hierarchical model of all EJB projects. Each EJB project contains the following sub-folders for organizing the different types of beans and the mappings: <ul><li><span class="uicontrol">Session Beans</span></li> @@ -55,11 +48,22 @@ the mappings: <ul><li><span class="uicontrol">Session Beans</span></li> <li><span class="uicontrol">Maps</span></li> </ul> </dd> -<dt class="dlterm">Enterprise Applications</dt> -<dd>Shows a hierarchical model of all enterprise application projects.</dd> +<dt class="dlterm">Other Projects</dt> +<dd>Shows any non-J2EE module projects, such as Java projects. These Java projects +can be any of the following types: <ul><li>Utility projects for existing Enterprise Application projects in your +workspace</li> +<li>EJB Client JAR Projects, which include the client interface classes (remote, +home, local, or local home interfaces) for beans in EJB projects</li> +<li>Java projects +that are in your workspace but unrelated to your J2EE development</li> +</ul> +</dd> </dl> </div> </div> -<div></div> -</body> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-j2eeapp.html" title="These topics deal with the Java 2 Platform, Enterprise Edition (J2EE).">J2EE Applications</a></div> +</div> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antejb.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antejb.html new file mode 100644 index 000000000..5e325b63b --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antejb.html @@ -0,0 +1,44 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /><!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Ant tasks for EJB-enabled tools</title> +</head> +<body id="ph-antejb"><a name="ph-antejb"><!-- --></a> +<h1 class="topictitle1">Ant tasks for EJB-enabled tools</h1> +<div><p></p> +</div> +<div> +<ul class="ullinks"> +<li class="ulchildlink"><strong><a href="../topics/tantaxbn.html">AccessBeanRegeneration</a></strong><br /> +This task performs the same operation as the <span class="uicontrol">Regenerate +Access Beans</span> menu action, for regenerating access beans in an +EJB project. This is not available in WebSphere<sup>®</sup> Studio Site Developer or WebSphere Application +Server Express.</li> +<li class="ulchildlink"><strong><a href="../topics/tantejbd.html">EJBDeploy</a></strong><br /> +This task generates deployment code and RMIC code for an EJB Project. +Only available where EJB deploy tools are available.</li> +<li class="ulchildlink"><strong><a href="../topics/tantejbe.html">EJBExport</a></strong><br /> +This task performs the same operation as the EJB JAR file export +wizard for exporting an EJB Project to an EJB Jar file. This task is not available +in products that do not include EJB development tools.</li> +</ul> + +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antgeneral.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antgeneral.html new file mode 100644 index 000000000..0a54669c1 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antgeneral.html @@ -0,0 +1,89 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>General Ant tasks</title> +</head> +<body id="ph-antgeneral"><a name="ph-antgeneral"><!-- --></a> +<h1 class="topictitle1">General Ant tasks</h1> +<div><p></p> +</div> +<div> +<ul class="ullinks"> +<li class="ulchildlink"><strong><a href="../topics/tantcapturebuildmessages.html">captureBuildMessages</a></strong><br /> +This task captures Ant build messages and allows them to be searched +or displayed, and allows conditional Ant build failures depending on whether +or not a specified string is in the captured build messages.</li> +<li class="ulchildlink"><strong><a href="../topics/tantcompilew.html">compileWorkspace</a></strong><br /> +This task compiles the entire workspace. It performs the same action +as javac. While this task is running, all the validation and other builders +are turned of</li> +<li class="ulchildlink"><strong><a href="../topics/tantgetj.html">getJavacErrorCount</a></strong><br /> +This task gets the error count for the last internal javac compilation +of the specified project.</li> +<li class="ulchildlink"><strong><a href="../topics/tantgetp.html">getProjectData</a></strong><br /> +This task gets the specified project information.</li> +<li class="ulchildlink"><strong><a href="../topics/tantproj.html">projectBuild</a></strong><br /> +This task builds the specified project.</li> +<li class="ulchildlink"><strong><a href="../topics/tantprojectgeterrors.html">projectGetErrors</a></strong><br /> +This task gets the errors for the specified project. It is a subset +of the projectBuild task (it does not do a build, it just gets project errors +regardless of how they were created)</li> +<li class="ulchildlink"><strong><a href="../topics/tantprojectimport.html">projectImport</a></strong><br /> +This task imports an existing file system project into a workspace.</li> +<li class="ulchildlink"><strong><a href="../topics/tantprojectsetbuild.html">projectSetBuild</a></strong><br /> +This task builds a set of Eclipse projects using an existing Eclipse +team Project Set File ("PSF"). The PSF must have been first created using +an Eclipse team "Project Set Export" command, and then the task projectSetImport +must have been used to import those projects into a workspace.</li> +<li class="ulchildlink"><strong><a href="../topics/tantprojectsetimport.html">projectSetImport</a></strong><br /> +This task imports an existing Eclipse team Project Set File (PSF) +into a workspace. The PSF must have been first created using an Eclipse team +"Project Set Export" command.</li> +<li class="ulchildlink"><strong><a href="../topics/tantsetd.html">setDebugInfo</a></strong><br /> +This task sets the internal Java™ compilation debug level, and returns +the current settings.</li> +<li class="ulchildlink"><strong><a href="../topics/tantworkspacebuild.html">workspaceBuild</a></strong><br /> +This task builds the entire workspace.</li> +<li class="ulchildlink"><strong><a href="../topics/tantworkspacegeterrors.html">workspaceGetErrors</a></strong><br /> +This task gets the errors for the entire workspace. It is a subset +of the workspaceBuild task (it does not do a build, it just gets workspace +errors regardless of how they were created).</li> +<li class="ulchildlink"><strong><a href="../topics/tantworkspacepreferencefile.html">workspacePreferenceFile</a></strong><br /> +This task reads a property file containing Eclipse workspace preferences +and sets those preferences.</li> +<li class="ulchildlink"><strong><a href="../topics/tantworkspacepreferenceget.html">workspacePreferenceGet</a></strong><br /> +This task gets Eclipse workspace preferences.</li> +<li class="ulchildlink"><strong><a href="../topics/tantworkspacepreferenceset.html">workspacePreferenceSet</a></strong><br /> +This task sets Eclipse workspace preferences.</li> +</ul> + +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antj2ee.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antj2ee.html new file mode 100644 index 000000000..d27578802 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-antj2ee.html @@ -0,0 +1,50 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Ant tasks for J2EE</title> +</head> +<body id="ph-antj2ee"><a name="ph-antj2ee"><!-- --></a> +<h1 class="topictitle1">Ant tasks for J2EE</h1> +<div><p></p> +</div> +<div> +<ul class="ullinks"> +<li class="ulchildlink"><strong><a href="../topics/tantautoappinstall.html">autoAppInstall</a></strong><br /> +This task uses the WebSphere<sup>®</sup> Rapid Deploy feature to +install an application.</li> +<li class="ulchildlink"><strong><a href="../topics/tantappc.html">AppClientExport</a></strong><br /> +This task performs the same operation as the Application Client +export wizard for exporting an Application Client Project to an Application +Client JAR file.</li> +<li class="ulchildlink"><strong><a href="../topics/tanteare.html">EARExport</a></strong><br /> +This task performs the same operation as the EAR file export wizard +for exporting an Enterprise Application Project to an EAR file.</li> +<li class="ulchildlink"><strong><a href="../topics/tantutil.html">UtilJar</a></strong><br /> +(DEPRECATED) This task compresses source and/or build output of +a Java™ project +into a JAR file and places the JAR file in an Enterprise Application Project.</li> +<li class="ulchildlink"><strong><a href="../topics/tantware.html">WARExport</a></strong><br /> +This task performs the same operation as the WAR file export wizard +for exporting a Web Project to a WAR file.</li> +</ul> + +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-importexport.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-importexport.html index 7e466ba74..d1c1276b8 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-importexport.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-importexport.html @@ -4,6 +4,9 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,7 +17,8 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Importing and exporting projects and files</title> </head> <body id="ph-importexport"><a name="ph-importexport"><!-- --></a> @@ -30,6 +34,9 @@ You can export an application client project as a JAR file.</li> Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.</li> +<li class="ulchildlink"><strong><a href="../topics/tjexprar.html">Exporting connector projects to RAR files</a></strong><br /> +You can export a connector project to a RAR file in preparation +for deploying it to a server.</li> <li class="ulchildlink"><strong><a href="../topics/tjimpear.html">Importing an enterprise application EAR file</a></strong><br /> Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed @@ -38,6 +45,11 @@ EAR file.</li> Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.</li> +<li class="ulchildlink"><strong><a href="../topics/tjimprar.html">Importing a connector project RAR file</a></strong><br /> +Connector projects are deployed into RAR files. You can import +a connector project by importing a deployed RAR file.</li> +<li class="ulchildlink"><strong><a href="../topics/cjcircle.html">Cyclical dependencies between J2EE modules</a></strong><br /> +</li> <li class="ulchildlink"><strong><a href="../topics/tjcircleb.html">Correcting cyclical dependencies after an EAR is imported</a></strong><br /> You can resolve cyclical dependencies after an EAR is imported.</li> </ul> diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-j2eeapp.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-j2eeapp.html new file mode 100644 index 000000000..01aa5fd78 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-j2eeapp.html @@ -0,0 +1,47 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>J2EE Applications</title> +</head> +<body id="ph-j2eeapp"><a name="ph-j2eeapp"><!-- --></a> +<h1 class="topictitle1">J2EE Applications</h1> +<div><p>These topics deal with the Java™ 2 Platform, Enterprise Edition (J2EE).</p> +</div> +<div> +<ul class="ullinks"> +<li class="ulchildlink"><strong><a href="../topics/cjarch.html">J2EE architecture</a></strong><br /> +The Java 2 Platform, Enterprise Edition (J2EE) provides +a standard for developing multitier, enterprise services.</li> +<li class="ulchildlink"><strong><a href="../topics/cjpers.html">J2EE perspective</a></strong><br /> +The J2EE perspective includes workbench views that you can use +when developing resources for enterprise applications, EJB modules, Web modules, +application client modules, and connector projects or modules.</li> +<li class="ulchildlink"><strong><a href="../topics/cjview.html">Project Explorer view in the J2EE perspective</a></strong><br /> +While developing J2EE applications in the J2EE perspective, the +Project Explorer view is your main view of your J2EE projects and resources.</li> +<li class="ulchildlink"><strong><a href="../topics/ph-projects.html">Working with projects</a></strong><br /> +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.</li> +<li class="ulchildlink"><strong><a href="../topics/tjval.html">Validating code in enterprise applications</a></strong><br /> +</li> +<li class="ulchildlink"><strong><a href="../topics/ph-ref.html">Reference</a></strong><br /> +The following reference material on J2EE is available:</li> +</ul> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-projects.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-projects.html index ff0cb1c71..4ea0b733d 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-projects.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-projects.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,7 +16,8 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Working with projects</title> </head> <body id="phprojects"><a name="phprojects"><!-- --></a> @@ -36,6 +39,9 @@ to as an EAR file.</li> <li class="ulchildlink"><strong><a href="../topics/tjappproj.html">Creating an application client project</a></strong><br /> You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.</li> +<li class="ulchildlink"><strong><a href="../topics/tjrar.html">Creating a connector project</a></strong><br /> +A connector is a J2EE standard extension mechanism for containers +to provide connectivity to enterprise information systems (EISs).</li> <li class="ulchildlink"><strong><a href="../topics/tjtargetserver.html">Specifying target servers for J2EE projects</a></strong><br /> When you develop J2EE applications, the workbench requires that you specify the server runtime environments for your J2EE projects. The target @@ -45,12 +51,6 @@ for setting the class path for J2EE projects.</li> <li class="ulchildlink"><strong><a href="../topics/ph-importexport.html">Importing and exporting projects and files</a></strong><br /> These topics cover how to import files and projects into the workbench and export files and projects to disk.</li> -<li class="ulchildlink"><strong><a href="../topics/cjbinary.html">Binary project support</a></strong><br /> -</li> -<li class="ulchildlink"><strong><a href="../topics/tjmigrate.html">Migrating J2EE projects</a></strong><br /> -Use the J2EE Migration wizard to migrate the project structures -and J2EE specification level of enterprise application projects and associated -modules.</li> </ul> <div class="familylinks"> diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-ref.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-ref.html index 59eca4a06..6994033ed 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-ref.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/ph-ref.html @@ -3,8 +3,7 @@ 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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<!-- /******************************************************************************* +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><!-- /******************************************************************************* * Copyright (c) 2000, 2005 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 @@ -14,7 +13,8 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Reference</title> </head> <body id="ph-ref"><a name="ph-ref"><!-- --></a> diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/rjlimitcurrent.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/rjlimitcurrent.html index b73922b83..a95a4d779 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/rjlimitcurrent.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/rjlimitcurrent.html @@ -14,11 +14,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Limitations of J2EE development tools</title> </head> <body id="rjlimitcurrent"><a name="rjlimitcurrent"><!-- --></a> - <h1 class="topictitle1">Limitations of J2EE development tools</h1> <div><p>This topic outlines current known limitations and restrictions for J2EE tooling.</p> @@ -72,5 +72,9 @@ this message you then select a valid project location by clicking the Browse button, the project creation will still not finish. The workaround is to click Cancel and reopen the project creation wizard.</div> </div> -</body> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-ref.html" title="The following reference material on J2EE is available:">Reference</a></div> +</div> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalerr.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalerr.html index 389a7eea7..91280dcf2 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalerr.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalerr.html @@ -14,26 +14,26 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Common validation errors and solutions</title> </head> <body id="rvalerr"><a name="rvalerr"><!-- --></a> - <h1 class="topictitle1">Common validation errors and solutions</h1> <div><p>You may encounter these common error messages when you validate your projects.</p> -<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="20.27027027027027%" id="d0e16">Message prefix</th> -<th valign="top" width="24.324324324324326%" id="d0e18">Message</th> -<th valign="top" width="55.4054054054054%" id="d0e20">Explanation</th> +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="20.27027027027027%" id="d0e33">Message prefix</th> +<th valign="top" width="24.324324324324326%" id="d0e35">Message</th> +<th valign="top" width="55.4054054054054%" id="d0e37">Explanation</th> </tr> </thead> -<tbody><tr><td colspan="3" valign="top" headers="d0e16 d0e18 d0e20 "><span class="uicontrol">Application Client validator</span></td> +<tbody><tr><td colspan="3" valign="top" headers="d0e33 d0e35 d0e37 "><span class="uicontrol">Application Client validator</span></td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ1000</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">Validation failed because the application client file +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ1000</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">Validation failed because the application client file is not valid. Ensure that the deployment descriptor is valid.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">The application-client.xml file cannot be loaded. The +<td valign="top" width="55.4054054054054%" headers="d0e37 ">The application-client.xml file cannot be loaded. The project metadata cannot be initialized from the application-client.xml file. <ol><li>Ensure the following: <ul><li>that the META-INF folder exists in the application client project</li> <li>that META-INF contains the application-client.xml file</li> @@ -48,11 +48,11 @@ rebuild the project. The project metadata will refresh.</li> </ol> </td> </tr> -<tr><td colspan="3" valign="top" headers="d0e16 d0e18 d0e20 "><span class="uicontrol">EAR validator</span></td> +<tr><td colspan="3" valign="top" headers="d0e33 d0e35 d0e37 "><span class="uicontrol">EAR validator</span></td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ1001</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">The EAR project {0} is invalid.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">The application.xml file cannot be loaded. The project +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ1001</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">The EAR project {0} is invalid.</td> +<td valign="top" width="55.4054054054054%" headers="d0e37 ">The application.xml file cannot be loaded. The project metadata cannot be initialized from the application.xml file. <ol><li>Ensure the following: <ul><li>that the META-INF folder exists in the EAR project</li> <li>that META-INF contains <samp class="codeph">application.xml</samp></li> <li>that META-INF is in the project's classpath.</li> @@ -66,11 +66,11 @@ rebuild the project. The project metadata will refresh.</li> </ol> </td> </tr> -<tr><td colspan="3" valign="top" headers="d0e16 d0e18 d0e20 "><span class="uicontrol">EJB validator</span></td> +<tr><td colspan="3" valign="top" headers="d0e33 d0e35 d0e37 "><span class="uicontrol">EJB validator</span></td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2019</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">The {0} key class must be serializable at runtime. </td> -<td rowspan="3" valign="top" width="55.4054054054054%" headers="d0e20 ">The EJB is compliant with the EJB specification. This +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2019</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">The {0} key class must be serializable at runtime. </td> +<td rowspan="3" valign="top" width="55.4054054054054%" headers="d0e37 ">The EJB is compliant with the EJB specification. This message is a warning that problems may occur. The warning appears when a type needs to be serializable at runtime and when serializability cannot be verified at compile-time. A type is serializable if, at runtime, it is a primitive @@ -78,31 +78,31 @@ type, a primitive array, a remote object, or if it implements java.io.Serializab This message flags java.lang.Object and it cannot be disabled. You can either make the object serializable at compile-time or ignore the warning. </td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2412</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">The return type must be serializable at runtime. </td> +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2412</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">The return type must be serializable at runtime. </td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2413</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">Argument {1} of {0} must be serializable at runtime.</td> +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2413</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">Argument {1} of {0} must be serializable at runtime.</td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2102</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">Either a finder descriptor, or a matching custom finder method on the +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2102</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">Either a finder descriptor, or a matching custom finder method on the {0} class, must be defined.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">A finder descriptor must exist for every finder method.</td> +<td valign="top" width="55.4054054054054%" headers="d0e37 ">A finder descriptor must exist for every finder method. </td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2873</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">Migrate this bean's datasource binding to a CMP Connection Factory +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2873</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">Migrate this bean's datasource binding to a CMP Connection Factory binding.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 "> </td> +<td valign="top" width="55.4054054054054%" headers="d0e37 "> </td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2874</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">Migrate this EJB module's default datasource binding to a default CMP +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2874</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">Migrate this EJB module's default datasource binding to a default CMP Connection Factory binding.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 "> </td> +<td valign="top" width="55.4054054054054%" headers="d0e37 "> </td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2875E </td> -<td valign="top" width="24.324324324324326%" headers="d0e18 "><ejb-client-jar> {0} must exist in every EAR file +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2875E </td> +<td valign="top" width="24.324324324324326%" headers="d0e35 "><ejb-client-jar> {0} must exist in every EAR file that contains this EJB module.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">If <samp class="codeph"><ejb-client-jar></samp> is specified +<td valign="top" width="55.4054054054054%" headers="d0e37 ">If <samp class="codeph"><ejb-client-jar></samp> is specified in <span class="filepath">ejb-jar.xml</span>, a corresponding EJB client project must contain the home and remote interfaces and any other types that a client will need. If these types are all contained in a single EJB project, delete the <samp class="codeph"><ejb-client-jar></samp> line @@ -110,10 +110,10 @@ in the deployment descriptor. Otherwise, ensure that the EJB client project exists, is open, and is a project utility JAR in every EAR that uses this EJB project as a module.</td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ2905</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">The EJB validator did not run because ejb-jar.xml could not be loaded. +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ2905</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">The EJB validator did not run because ejb-jar.xml could not be loaded. Run the XML validator for more information.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">CHKJ2905 means that the project's metadata could not be initialized +<td valign="top" width="55.4054054054054%" headers="d0e37 ">CHKJ2905 means that the project's metadata could not be initialized from ejb-jar.xml. <ol><li>Ensure the following: <ul><li>that the META-INF folder exists in the EJB project</li> <li>that META-INF contains ejb-jar.xml</li> <li>that META-INF is in the project's classpath.</li> @@ -126,25 +126,25 @@ rebuild the project. The project metadata will refresh.</li> </ol> </td> </tr> -<tr><td colspan="3" valign="top" headers="d0e16 d0e18 d0e20 "><span class="uicontrol">JSP syntax validator</span></td> +<tr><td colspan="3" valign="top" headers="d0e33 d0e35 d0e37 "><span class="uicontrol">JSP validator</span></td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">IWAW0482</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">No valid JspTranslator</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">There is a path problem with the project; the JSP Validator -needs access to the server runtime code. If IWAW0482E appears on all web projects, +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">IWAW0482</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">No valid JspTranslator</td> +<td valign="top" width="55.4054054054054%" headers="d0e37 ">There is a path problem with the project; the JSP Validator +needs access to the WAS runtime code. If IWAW0482E appears on all web projects, check the Variable or JRE path: <ol><li>Check the global preferences (<span class="uicontrol">Window > Preferences > Java >Installed JREs</span>) and make sure that the location for the JRE is pointing to a valid JRE directory. </li> <li>Ensure that the classpath variables (<span class="uicontrol">Window > Preferences > -Java > Build Path > Classpath Variables</span>) are set correctly. </li> +Java > Classpath Variables</span>) are set correctly.</li> </ol> </td> </tr> -<tr><td colspan="3" valign="top" headers="d0e16 d0e18 d0e20 "><span class="uicontrol">WAR validator</span></td> +<tr><td colspan="3" valign="top" headers="d0e33 d0e35 d0e37 "><span class="uicontrol">WAR validator</span></td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 ">CHKJ3008</td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">Missing or invalid WAR file.</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">The web.xml file cannot be loaded. The project metadata +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 ">CHKJ3008</td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">Missing or invalid WAR file.</td> +<td valign="top" width="55.4054054054054%" headers="d0e37 ">The web.xml file cannot be loaded. The project metadata cannot be initialized from the web.xml file. <ol><li>Ensure the following: <ul><li>that the WEB-INF folder exists in the web project</li> <li>that WEB-INF contains the web.xml file</li> <li>that WEB-INF is in the project's classpath.</li> @@ -157,12 +157,12 @@ rebuild the project. The project metadata will refresh.</li> </ol> </td> </tr> -<tr><td colspan="3" valign="top" headers="d0e16 d0e18 d0e20 "><span class="uicontrol">XML validator</span></td> +<tr><td colspan="3" valign="top" headers="d0e33 d0e35 d0e37 "><span class="uicontrol">XML validator</span></td> </tr> -<tr><td valign="top" width="20.27027027027027%" headers="d0e16 "> </td> -<td valign="top" width="24.324324324324326%" headers="d0e18 ">The content of element type "ejb-jar" is incomplete, it must match +<tr><td valign="top" width="20.27027027027027%" headers="d0e33 "> </td> +<td valign="top" width="24.324324324324326%" headers="d0e35 ">The content of element type "ejb-jar" is incomplete, it must match "(description?,display-name?,small-icon?,large-icon?,enterprise-beans,assembly-descriptor?,ejb-client-jar?)".</td> -<td valign="top" width="55.4054054054054%" headers="d0e20 ">The EJB 1.1 and 2.0 specifications mandate that at least one enterprise +<td valign="top" width="55.4054054054054%" headers="d0e37 ">The EJB 1.1 and 2.0 specifications mandate that at least one enterprise bean must exist in an EJB .jar file. This error message is normal during development of EJB .jar files and can be ignored until you perform a production action, such as exporting or deploying code. Define at least one enterprise bean in @@ -176,12 +176,15 @@ the project.</td> <div class="familylinks"> <div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjval.html">Validating code in enterprise applications</a></div> </div> + +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-ref.html" title="The following reference material on J2EE is available:">Reference</a></div> +</div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjval.html">Validating code in enterprise applications</a></div> </div> <div class="relref"><strong>Related reference</strong><br /> <div><a href="../topics/rvalidators.html" title="This table lists the validators that are available for the different project types and gives a brief description of each validator.">J2EE Validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalidators.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalidators.html index efac0a3b6..2d6441058 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalidators.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/rvalidators.html @@ -4,7 +4,6 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -15,36 +14,36 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>J2EE Validators</title> </head> <body id="rvalidators"><a name="rvalidators"><!-- --></a> - <h1 class="topictitle1">J2EE Validators</h1> <div><p>This table lists the validators that are available for the different project types and gives a brief description of each validator.</p> -<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="50%" id="d0e15">Validator name</th> -<th valign="top" width="50%" id="d0e17">Description</th> +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="50%" id="d0e24">Validator name</th> +<th valign="top" width="50%" id="d0e26">Description</th> </tr> </thead> -<tbody><tr><td align="left" valign="top" width="50%" headers="d0e15 ">Application Client Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The Application Client Validator validates +<tbody><tr><td align="left" valign="top" width="50%" headers="d0e24 ">Application Client Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The Application Client Validator validates the following Application Client project resources: <ul><li>Deployment descriptor (application-client.xml)</li> <li>EJB references</li> <li>Resource references</li> </ul> </td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">DTD Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The DTD validator determines whether the +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">DTD Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The DTD validator determines whether the current state of a DTD is semantically valid. XML files are validated according -to the the XML specification <a href="http://www.w3.org/TR/2000/REC-xml-20001006" target="_blank"> Extensible Markup Language (XML) 1.0</a> from the W3C +to the XML specification <a href="http://www.w3.org/TR/2000/REC-xml-20001006" target="_blank"> Extensible Markup Language (XML) 1.0</a> from the W3C Web site. As well, the DTD validator checks for errors such as references to entities and elements that do not exist.</td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">EAR Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The EAR Validator validates the following: +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">EAR Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The EAR Validator validates the following: <ul><li>EAR deployment descriptor (application.xml)</li> <li>EJB references of all module projects in the enterprise application project</li> <li>Security roles</li> @@ -59,8 +58,8 @@ any utility and module projects</li> of the module projects with respect to the enterprise application project.</p> </td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">EJB Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The EJB Validator verifies that enterprise +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">EJB Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The EJB Validator verifies that enterprise beans contained in an EJB project comply with the Sun Enterprise JavaBeans™ Specifications (1.1, 2.0, and 2.1), depending on the level of the bean. Code validation for the EJB 1.0 specification is not supported. <p>Specifically, the EJB Validator @@ -69,29 +68,28 @@ validates the following resources: </p> files that are members of an enterprise bean (home interface, remote interface, enterprise bean class, and, if the bean is an entity bean, the key class)</li> <li>ejb-jar.xml</li> -<li>ibm-ejb-jar-ext.xmi </li> </ul> - </td> +</td> </tr> -<tr><td valign="top" width="50%" headers="d0e15 ">Connector Validator</td> -<td valign="top" width="50%" headers="d0e17 ">The Connector validator checks for invalid J2EE specification +<tr><td valign="top" width="50%" headers="d0e24 ">Connector Validator</td> +<td valign="top" width="50%" headers="d0e26 ">The Connector validator checks for invalid J2EE specification levels in connector projects.</td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">HTML Syntax Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The HTML Syntax Validator validates HTML +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">HTML Syntax Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The HTML Syntax Validator validates HTML basic syntax and HTML DTD compliance in the following Web project resources: <ul><li>HTML files</li> <li>JSP files</li> </ul> </td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">JSP Syntax Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The JSP Syntax Validator validates -JSP files in a project by translating them into the corresponding Java code +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">JSP Syntax Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The JSP Syntax Validator validates JSP files +in a project by translating them into the corresponding Java code and then checking the Java code for compile errors.</td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">WAR Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The WAR Validator validates the following +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">WAR Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The WAR Validator validates the following web project resources: <ul><li>Deployment descriptor (web.xml)</li> <li>Servlets</li> <li>Security roles</li> @@ -100,32 +98,30 @@ web project resources: <ul><li>Deployment descriptor (web.xml)</li> </ul> </td> </tr> -<tr><td valign="top" width="50%" headers="d0e15 ">WSDL Validator</td> -<td valign="top" width="50%" headers="d0e17 ">The WSDL validator checks the following in WSDL files: <ul><li>XML syntax</li> +<tr><td valign="top" width="50%" headers="d0e24 ">WSDL Validator</td> +<td valign="top" width="50%" headers="d0e26 ">The WSDL validator checks the following in WSDL files: <ul><li>XML syntax</li> <li>XML Schema types in the <types> section</li> <li>Referential integrity of the various constructs in WSDL </li> </ul> The validator also includes an extension point to allow other validators to be plugged into the WSDL validation to provide additional verification of the WSDL file. Through this mechanism, interoperability is checked by validating -a WSDL file against WS-I Profiles. <p>This validator is not available in WebSphere<sup>®</sup> Studio -Site Developer.</p> -</td> +a WSDL file against WS-I Profiles. </td> </tr> -<tr><td valign="top" width="50%" headers="d0e15 ">WS-I Message Validator</td> -<td valign="top" width="50%" headers="d0e17 ">WS-I Message validator checks SOAP messages against +<tr><td valign="top" width="50%" headers="d0e24 ">WS-I Message Validator</td> +<td valign="top" width="50%" headers="d0e26 ">WS-I Message validator checks SOAP messages against WS-I Profiles. A user can capture and verify SOAP messages using the TCP/IP Monitor. The validator checks a message log that is saved as a project resource (.wsimsg). The log conforms to a format as specified by WS-I.</td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">XML Schema Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The XML schema validator determines whether +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">XML Schema Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The XML schema validator determines whether the current state of an XML schema file is semantically valid. XML schemas are validated according to the XML Schema specification <a href="http://www.w3.org/TR/xmlschema-1/"> XML Schema Part 1: Structures</a> from the W3C Web site.</td> </tr> -<tr><td align="left" valign="top" width="50%" headers="d0e15 ">XML Validator</td> -<td align="left" valign="top" width="50%" headers="d0e17 ">The XML validator ensures that an XML file +<tr><td align="left" valign="top" width="50%" headers="d0e24 ">XML Validator</td> +<td align="left" valign="top" width="50%" headers="d0e26 ">The XML validator ensures that an XML file is well-formed. It also verifies if an XML file is valid - that is, it follows the constraints established in the DTD or XML schema the XML file is associated with.</td> @@ -138,12 +134,15 @@ with.</td> <div class="familylinks"> <div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjval.html">Validating code in enterprise applications</a></div> </div> + +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-ref.html" title="The following reference material on J2EE is available:">Reference</a></div> +</div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjval.html">Validating code in enterprise applications</a></div> </div> <div class="relref"><strong>Related reference</strong><br /> <div><a href="../topics/rvalerr.html" title="You may encounter these common error messages when you validate your projects.">Common validation errors and solutions</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantappc.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantappc.html new file mode 100644 index 000000000..eede764a3 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantappc.html @@ -0,0 +1,77 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>AppClientExport</title> +</head> +<body id="tantappc"><a name="tantappc"><!-- --></a> +<h1 class="topictitle1">AppClientExport</h1> +<div><p>This task performs the same operation as the Application Client +export wizard for exporting an Application Client Project to an Application +Client JAR file.</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e21">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e23">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">AppClientProjectName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Name of the Application Client Project (<em>Case Sensitive</em>)</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">AppClientExportFile</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Absolute path of the Application Client JAR file.</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ExportSource</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether to include source files or not.</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> false</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">Overwrite</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether to overwrite if the file already exists.</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Export the project "ProjectClient" to "ProjectClient.jar" in the C Drive: <pre><appClientExport +AppClientProjectName="ProjectClient" +AppClientExportFile="C:\ProjectClient.jar"/></pre> +</li> +<li>Export the project "ProjectClient" with the source files to "ProjectClient.jar" +in the C Drive: <pre><appClientExport +AppClientProjectName="ProjectClient" +AppClientExportFile="C:\ProjectClient.jar" +ExportSource="true"/></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antj2ee.html" title="">Ant tasks for J2EE</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantautoappinstall.html" title="This task uses the WebSphere Rapid Deploy feature to install an application.">autoAppInstall</a></div> +<div><a href="../topics/tanteare.html" title="This task performs the same operation as the EAR file export wizard for exporting an Enterprise Application Project to an EAR file.">EARExport</a></div> +<div><a href="../topics/tantutil.html" title="(DEPRECATED) This task compresses source and/or build output of a Java project into a JAR file and places the JAR file in an Enterprise Application Project.">UtilJar</a></div> +<div><a href="../topics/tantware.html" title="This task performs the same operation as the WAR file export wizard for exporting a Web Project to a WAR file.">WARExport</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantautoappinstall.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantautoappinstall.html new file mode 100644 index 000000000..6a43c80fa --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantautoappinstall.html @@ -0,0 +1,94 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>autoAppInstall</title> +</head> +<body id="tantautoappinstall"><a name="tantautoappinstall"><!-- --></a> +<h1 class="topictitle1">autoAppInstall</h1> +<div><p>This task uses the WebSphere<sup>®</sup> Rapid Deploy feature to +install an application.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e23">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e25">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e27">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e23 ">Files</td> +<td valign="top" width="56.84210526315789%" headers="d0e25 ">The application file to be installed</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e27 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e23 ">ConfigData</td> +<td valign="top" width="56.84210526315789%" headers="d0e25 ">An optional configuration file</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e27 ">No</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e23 ">ProjectName</td> +<td valign="top" width="56.84210526315789%" headers="d0e25 ">The name of the Eclipse project to create</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e27 ">No, default is <em>AutoAppInstall</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e23 ">PropertyErrorCount</td> +<td valign="top" width="56.84210526315789%" headers="d0e25 ">Property to receive the project error count</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e27 ">No, default is <em>ProjectErrorCount</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e23 ">PropertyErrorMessages</td> +<td valign="top" width="56.84210526315789%" headers="d0e25 ">Property to receive the project error messages</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e27 ">No, default is <em>ProjectErrorMessages</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e23 ">ConsoleOutput</td> +<td valign="top" width="56.84210526315789%" headers="d0e25 ">Whether or not to output extra progress messages to +the console log</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e27 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Install the MyTest application using a configuration file:<pre><autoAppInstall + Files="X:/MyPath/MyTest.jsp" + ConfigData="MyConfigData.xml" + ConsoleOutput="true" /> +<echo message="compiler problem.unusedImport=${unusedImport}" /></pre> +</li> +<li>An optional <samp class="codeph">configData.xml</samp> file:<pre><?xml version="1.0" encoding="ASCII"?> +<com.ibm.ws.rd.headlessmodel:HeadlessConfiguration + xmlns:com.ibm.ws.rd.headlessmodel="http:///com/ibm/ws/rd/headlessmodel.ecore"> + <project name="AutoAppInstall" + workspaceLocation="X:\MyWorkspace" + styleID="Auto Application Install"> + <targetServer serverName="server1" + serverJMXHost="localhost" + serverJMXPort="8880" + watchInterval="5"/> + </project> +</com.ibm.ws.rd.headlessmodel:HeadlessConfiguration></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antj2ee.html" title="">Ant tasks for J2EE</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantappc.html" title="This task performs the same operation as the Application Client export wizard for exporting an Application Client Project to an Application Client JAR file.">AppClientExport</a></div> +<div><a href="../topics/tanteare.html" title="This task performs the same operation as the EAR file export wizard for exporting an Enterprise Application Project to an EAR file.">EARExport</a></div> +<div><a href="../topics/tantutil.html" title="(DEPRECATED) This task compresses source and/or build output of a Java project into a JAR file and places the JAR file in an Enterprise Application Project.">UtilJar</a></div> +<div><a href="../topics/tantware.html" title="This task performs the same operation as the WAR file export wizard for exporting a Web Project to a WAR file.">WARExport</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantaxbn.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantaxbn.html new file mode 100644 index 000000000..5d2e3e2e6 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantaxbn.html @@ -0,0 +1,63 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>AccessBeanRegeneration</title> +</head> +<body id="tantaxbn"><a name="tantaxbn"><!-- --></a> +<h1 class="topictitle1">AccessBeanRegeneration</h1> +<div><p>This task performs the same operation as the <span class="uicontrol">Regenerate +Access Beans</span> menu action, for regenerating access beans in an +EJB project. This is not available in WebSphere<sup>®</sup> Studio Site Developer or WebSphere Application +Server Express.</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="22.64808362369338%" id="d0e30">Attribute</th> +<th align="left" valign="top" width="56.79442508710801%" id="d0e32">Description</th> +<th align="left" valign="top" width="20.557491289198605%" id="d0e34">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e30 ">EJBProjectName</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e32 ">Name of the EJB Project (<em>Case Sensitive</em>)</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e34 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e30 ">SuspendProjectValidation</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e32 ">Indicates whether validation should be suspended after +access bean generation. Otherwise all registered validators run on the project.</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e34 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Regenerate the access beans in the EJB project named "Sample", and allow +validation to proceed: <pre><accessBeanRegeneration +ejbProjectName = "Sample" +suspendProjectValidation = "false" > +</accessBeanRegeneration></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antejb.html" title="">Ant tasks for EJB-enabled tools</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantcapturebuildmessages.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantcapturebuildmessages.html new file mode 100644 index 000000000..d3a0fd0fe --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantcapturebuildmessages.html @@ -0,0 +1,117 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>captureBuildMessages</title> +</head> +<body id="tantcapturebuildmessages"><a name="tantcapturebuildmessages"><!-- --></a> +<h1 class="topictitle1">captureBuildMessages</h1> +<div><p>This task captures Ant build messages and allows them to be searched +or displayed, and allows conditional Ant build failures depending on whether +or not a specified string is in the captured build messages.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e20">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e22">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">action </td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The capturing action to be performed</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes. May be one of the following: <ul><li><em>start</em></li> +<li><em>stop</em></li> +<li><em>getAllMessages</em></li> +<li><em>findMessage</em></li> +<li><em>FailOnErrorMessagePresent</em></li> +<li><em>FailOnErrorMessageMissing</em></li> +</ul> +</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">MessageLevel</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The level of Ant build messages to capture</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>Information</em>. May be <em>error</em>, <em>warning</em>, <em>information</em>, <em>debug</em>, +or <em>verbose</em>.</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">SearchString</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">A string to be searched for (only valid for <em>findMessage</em> or <em>FailOnErrorMessagePresent</em> or <em>FailOnErrorMessageMissing</em>)</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes (for search actions)</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PropertyMessagesName</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Property to receive Get/Search action Message result</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>BuildMessages</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">ErrorPrefixMessage</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">A string prefix to be output before any FailOnError +failure message</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No</td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Perform a projectBuild and display the build messages:<pre><captureBuildMessages action="start" + messagelevel="information" /> +<projectBuild ProjectName="myProject" /> +<captureBuildMessages action="stop" /> +<captureBuildMessages action="getAllMessages" + propertymessagesname="BuildMessages" /> +<echo message="projectBuild: + build messages=${BuildMessages}" /></pre> +</li> +<li>Search the previous build messages for a target string, and then fail +if an error string is present:<pre><captureBuildMessages action="findMessage" + searchstring="${TargetSearchString}" + propertymessagesname="FoundMessages" /> +<echo message="projectBuild: search found + target messages=${FoundMessages}" /> +<captureBuildMessages action="failOnErrorMessagePresent" + searchstring="${ErrorMessageString}" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantcompilew.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantcompilew.html new file mode 100644 index 000000000..3852e7313 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantcompilew.html @@ -0,0 +1,82 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>compileWorkspace</title> +</head> +<body id="tantcompilew"><a name="tantcompilew"><!-- --></a> +<h1 class="topictitle1">compileWorkspace</h1> +<div><p>This task compiles the entire workspace. It performs the same action +as javac. While this task is running, all the validation and other builders +are turned of</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="22.64808362369338%" id="d0e21">Attribute</th> +<th align="left" valign="top" width="56.79442508710801%" id="d0e23">Description</th> +<th align="left" valign="top" width="20.557491289198605%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e21 ">BuildType</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e23 ">Type of build</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">No, default is <em>Incremental</em>. Can be <em>Incremental</em> or <em>Full</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e21 ">Quiet</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e23 ">Whether or not to print out messages</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Tip:</span> The quiet mode can give you a substantial +performance gain when running this Ant task in the workbench.</p> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Do a full compilation of the workspace: <pre><compileWorkspace BuildType="Full" /></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tanteare.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tanteare.html new file mode 100644 index 000000000..725d83e9d --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tanteare.html @@ -0,0 +1,76 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>EARExport</title> +</head> +<body id="tanteare"><a name="tanteare"><!-- --></a> +<h1 class="topictitle1">EARExport</h1> +<div><p>This task performs the same operation as the EAR file export wizard +for exporting an Enterprise Application Project to an EAR file.</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="22.64808362369338%" id="d0e21">Attribute</th> +<th valign="top" width="56.79442508710801%" id="d0e23">Description</th> +<th align="left" valign="top" width="20.557491289198605%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="22.64808362369338%" headers="d0e21 ">EARProjectName</td> +<td valign="top" width="56.79442508710801%" headers="d0e23 ">Name of the Enterprise Application Project (<em>Case Sensitive</em>)</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="22.64808362369338%" headers="d0e21 ">EARExportFile</td> +<td valign="top" width="56.79442508710801%" headers="d0e23 ">Absolute path of the EAR file.</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="22.64808362369338%" headers="d0e21 ">ExportSource</td> +<td valign="top" width="56.79442508710801%" headers="d0e23 ">Whether to include source files or not.</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">No, default is <em>false</em></td> +</tr> +<tr><td valign="top" width="22.64808362369338%" headers="d0e21 ">IncludeProjectMetaFiles</td> +<td valign="top" width="56.79442508710801%" headers="d0e23 ">Whether to include the project meta-data files that include the Java™ build +path, the project names, etc. Used when reimporting as binary projects.</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">No, default is <em>false</em></td> +</tr> +<tr><td valign="top" width="22.64808362369338%" headers="d0e21 ">Overwrite</td> +<td valign="top" width="56.79442508710801%" headers="d0e23 ">Whether to overwrite if the file already exists.</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e25 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Export the project "EARProject" to "EARProject.ear" in the C Drive: <pre><earExport EARProjectName="EARProject" EARExportFile="C:\EARProject.ear"/></pre> +</li> +<li>Export the project "EARProject" with the source files to "EARProject.ear" +in the C Drive: <pre><earExport EARProjectName="EARProject" EARExportFile="C:\EARProject.ear" ExportSource="true"/></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antj2ee.html" title="">Ant tasks for J2EE</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantautoappinstall.html" title="This task uses the WebSphere Rapid Deploy feature to install an application.">autoAppInstall</a></div> +<div><a href="../topics/tantappc.html" title="This task performs the same operation as the Application Client export wizard for exporting an Application Client Project to an Application Client JAR file.">AppClientExport</a></div> +<div><a href="../topics/tantutil.html" title="(DEPRECATED) This task compresses source and/or build output of a Java project into a JAR file and places the JAR file in an Enterprise Application Project.">UtilJar</a></div> +<div><a href="../topics/tantware.html" title="This task performs the same operation as the WAR file export wizard for exporting a Web Project to a WAR file.">WARExport</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantejbd.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantejbd.html new file mode 100644 index 000000000..9cad6c7bc --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantejbd.html @@ -0,0 +1,100 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>EJBDeploy</title> +</head> +<body id="tantejbd"><a name="tantejbd"><!-- --></a> +<h1 class="topictitle1">EJBDeploy</h1> +<div><p>This task generates deployment code and RMIC code for an EJB Project. +Only available where EJB deploy tools are available.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="13.186813186813188%" id="d0e20">Attribute</th> +<th align="left" valign="top" width="63.73626373626373%" id="d0e22">Description</th> +<th align="left" valign="top" width="23.076923076923077%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">EJBProject</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 ">Name of the EJB Project (<em>Case Sensitive</em>)</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">IgnoreErrors</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 ">Do not halt for compilation or validation errors</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">NoValidate</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 ">Disable the validation steps</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">Quiet</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 ">Only output errors, suppress informational messages</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">Use35Rules</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 "><deprecated>-Replaced by "Compatible35".</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">Compatible35</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 ">Use the WebSphere<sup>®</sup> 3.5 +compatible mapping rules</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="13.186813186813188%" headers="d0e20 ">CodeGen</td> +<td align="left" valign="top" width="63.73626373626373%" headers="d0e22 ">Only generate the deployment code, do not run RMIC or +Javac</td> +<td align="left" valign="top" width="23.076923076923077%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Generate Deployment code and RMIC code for "EJBProject", run validation +on the project, and print out any errors while compiling/validating the project. +If there are errors the operation comes to a halt: <pre><ejbDeploy EJBProject="EJBProject" /></pre> + </li> +<li>Generate Deployment code and RMIC code for "EJBProject" and run validation +on the project. But if there are any errors while validating/compiling, the +errors are reported and the operation continues: <pre><ejbDeploy EJBProject="EJBProject" IgnoreErrors="true"/></pre> +</li> +<li>Generate Deployment code and RMIC code for "EJBProject" but do not run +the validation steps. If there are any errors while compiling, the errors +are reported and the operation comes to a halt. <pre><ejbDeploy EJBProject="EJBProject" NoValidate="true"/></pre> +</li> +<li>Generate Deployment code and RMIC code for "EJBProject". Use WebSphere Version +3.5 mapping rules instead of Version 4.0. Run validation on the project, but +if there are any errors while validating or compiling, the errors are ignored +and the operation continues: <pre><ejbDeploy EJBProject="EJBProject" Compatible35="true"/></pre> +</li> +<li>Generate Deployment code and RMIC code for "EJBProject". Do not run the +validation on the project and do not display any messages expect for error +messages, in which case the operation comes to a halt: <pre><ejbDeploy EJBProject="EJBProject" NoValidate="true" Quiet="true"/></pre> +</li> +<li>Generate Deployment code for "EJBProject". Run validation on the project, +but ignore generation of the RMIC code: <pre><ejbDeploy EJBProject="EJBProject" CodeGen="true"/></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antejb.html" title="">Ant tasks for EJB-enabled tools</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantejbe.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantejbe.html new file mode 100644 index 000000000..9f759f428 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantejbe.html @@ -0,0 +1,73 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>EJBExport</title> +</head> +<body id="tantejbe"><a name="tantejbe"><!-- --></a> +<h1 class="topictitle1">EJBExport</h1> +<div><p>This task performs the same operation as the EJB JAR file export +wizard for exporting an EJB Project to an EJB Jar file. This task is not available +in products that do not include EJB development tools.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="17.073170731707318%" id="d0e20">Attribute</th> +<th align="left" valign="top" width="57.3170731707317%" id="d0e22">Description</th> +<th align="left" valign="top" width="25.609756097560975%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">EJBProjectName</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Name of the EJB Project (<em>Case Sensitive</em>)</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">EJBExportFile</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Absolute path of the EJB JAR file.</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">ExportSource</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Whether to include source files or not.</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">Overwrite</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Whether to overwrite if the file already exists.</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">No, default is<em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Export the project "EJBProject" to "EJBProject.jar" in the C Drive: <pre><ejbExport +EJBProjectName="EJBProject" +EJBExportFile="C:\EJBProject.jar"/></pre> +</li> +<li>Export the project "EJBProject" with the source files to "EJBProject.jar" +in the C Drive: <pre><ejbExport +EJBProjectName="EJBProject" +EJBExportFile="C:\EJBProject.jar" +ExportSource="true"/></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antejb.html" title="">Ant tasks for EJB-enabled tools</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantexampleautobuild.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantexampleautobuild.html new file mode 100644 index 000000000..68a900c6b --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantexampleautobuild.html @@ -0,0 +1,54 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Example: Automated Ant build</title> +</head> +<body id="tantexampleautobuild"><a name="tantexampleautobuild"><!-- --></a> +<h1 class="topictitle1">Example: Automated Ant build</h1> +<div><p>This example program shows a typical automated build using the +workbench Ant tasks.</p> +<div class="section">To run the automated Ant build example:</div> +<ol><li class="stepexpand"><span>Go to the com.ibm.etools.j2ee.ant directory under your workbench +installation (for example, <samp class="codeph">x:/<installdir>/rwd/eclipse/plugins/com.ibm.etools.j2ee.ant_*</samp>).</span></li> +<li class="stepexpand"><span>Edit the <samp class="codeph">runAnt.bat</samp> (or <samp class="codeph">runAnt.sh</samp>) +program to set your WORKSPACE variable.</span></li> +<li class="stepexpand"><span>Unzip the <samp class="codeph">Example.zip</samp> file. This creates an Example +directory with subdirectories.</span></li> +<li class="stepexpand"><span>Edit the file <samp class="codeph">buildExample.preferences</samp> to set +the variable WAS_60_INSTALLDIR. </span> <ul><li>Do not change the variable name.</li> +<li>The variable must point to a WebSphere<sup>®</sup> Application Server installation.</li> +</ul> +</li> +<li class="stepexpand"><span>Run <samp class="codeph">buildExample.bat</samp> (or <samp class="codeph">buildExample.sh</samp>). </span> <ul><li>Sample projects are imported and built (AdderJava, AdderWAR, AdderEJB, +AdderEAR)</li> +<li>AdderEAR.ear is created as the output result</li> +</ul> +</li> +</ol> +<div class="section"><div class="important"><span class="importanttitle">Important:</span> This is an Example program only. Do not use +it to build production applications.</div> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantexampleautodeploy.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantexampleautodeploy.html new file mode 100644 index 000000000..ad15e3694 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantexampleautodeploy.html @@ -0,0 +1,64 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Example: Automated Ant deploy</title> +</head> +<body id="tantexampleautodeploy"><a name="tantexampleautodeploy"><!-- --></a> +<h1 class="topictitle1">Example: Automated Ant deploy</h1> +<div><p>This example program shows a typical automated deployment using +the WebSphere<sup>®</sup> Application +Server Ant tasks.</p> +<div class="p">This example requires a WebSphere Application Server (v50 +or v51 or v60) to be installed and operating on the same machine.</div> +<div class="section">To run the automated Ant deploy example program:</div> +<ol><li class="stepexpand"><span>Go to the com.ibm.etools.j2ee.ant directory under your workbench +installation (for example, <samp class="codeph">x:/<installdir>/rwd/eclipse/plugins/com.ibm.etools.j2ee.ant_*</samp>).</span></li> +<li class="stepexpand"><span>Unzip the <samp class="codeph">Example.zip</samp> file. This creates an Example +directory with subdirectories, including an AdderDeploy folder.</span></li> +<li class="stepexpand"><span>Edit the <samp class="codeph">TestDeploy.bat</samp> file in the AdderDeploy +folder:</span><ul><li>Set the variables WASROOT and JACLWASROOT to point to a WebSphere Application +Server on the same machine. Be careful when defining these variables, making +sure that you use the correct syntax. One value requires back-slashes, while +the other requires forward-slashes.</li> +<li>Set the variables JACLbaseDir to be the current AdderDeploy directory.</li> +</ul> +</li> +<li class="stepexpand"><span>Edit the file <samp class="codeph">dist\AdderEAR-piot.targets</samp> to specify +what servers and/or clusters are to receive the deployed application:</span> <ul><li>Currently the testURL and TestResponse entries are processed but not actually +used</li> +</ul> +</li> +<li class="stepexpand"><span>Run <samp class="codeph">TestDeploy.bat</samp>.</span> The following must +be running:<ul><li>The WebSphere cell +Distribution Manager</li> +<li>The target server/cluster NodeAgents</li> +</ul> +</li> +</ol> +<div class="section"><div class="important"><span class="importanttitle">Important:</span> This is an Example program only. Do not use +it to deploy to production servers.</div> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantgetj.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantgetj.html new file mode 100644 index 000000000..3ce1902bc --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantgetj.html @@ -0,0 +1,82 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>getJavacErrorCount</title> +</head> +<body id="tantgetj"><a name="tantgetj"><!-- --></a> +<h1 class="topictitle1">getJavacErrorCount</h1> +<div><p>This task gets the error count for the last internal javac compilation +of the specified project.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="14.634146341463413%" id="d0e20">Attribute</th> +<th align="left" valign="top" width="48.78048780487805%" id="d0e22">Description</th> +<th align="left" valign="top" width="36.58536585365854%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="14.634146341463413%" headers="d0e20 ">ProjectName</td> +<td align="left" valign="top" width="48.78048780487805%" headers="d0e22 ">Name of project to be counted</td> +<td align="left" valign="top" width="36.58536585365854%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="14.634146341463413%" headers="d0e20 ">PropertyName</td> +<td align="left" valign="top" width="48.78048780487805%" headers="d0e22 ">Property Name to receive current settings</td> +<td align="left" valign="top" width="36.58536585365854%" headers="d0e24 ">No, Default is <em>JavacErrorCount </em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Display the error count for "myProject": <pre><getJavacErrorCount + ProjectName="MyProject" + PropertyName="MyJavacErrorCount" /> +<echo message="MyJavacErrorCount=${MyJavacErrorCount}" /></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantgetp.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantgetp.html new file mode 100644 index 000000000..e5a435f41 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantgetp.html @@ -0,0 +1,117 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>getProjectData</title> +</head> +<body id="tantgetp"><a name="tantgetp"><!-- --></a> +<h1 class="topictitle1">getProjectData</h1> +<div><p>This task gets the specified project information.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="22.64808362369338%" id="d0e20">Attribute</th> +<th align="left" valign="top" width="56.79442508710801%" id="d0e22">Description</th> +<th align="left" valign="top" width="20.557491289198605%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">ProjectName</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">The name of the project</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">Basedir (deprecated)</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">The fully qualified project basedir (typically X:\MYINSTALLDIR\MYWORKSPACE\MYPROJECT)</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No (deprecated).</td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">ProjectProperty (deprecated)</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property name to receive the project name</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No (deprecated), default is <em>projectName</em> </td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">WorkspaceProperty</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property name to receive the workspace path</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>workspaceName</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">LocationProperty</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property name to receive the project location</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>locationName</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">NatureProperty</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property name to receive the project nature</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>natureName</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">hasSpecifiedNature</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">The name of a project nature to be tested</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, no default (only enter a value if you want to test +if the project also has that specific nature)</td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">hasSpecifiedNatureProperty</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property name to receive true (or false) if the project +has (or does not have) the specified nature</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">Yes, if <em>hasSpecifiedNature</em> is present</td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">FailOnError</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Will cause the build to fail if the operation cannot complete +successfully (such as specifying an invalid project)</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Retrieve and display current project information: <pre><getProjectData projectName=${myProject} + hasSpecifiedNature="Java" + hasSpecifiedNatureProperty="isSpecifiedPropertyPresent" + failOnError="false" /> +<echo message="getProjectData: projectName=${projectName} + nature=${natureName} + workspace=${workspaceName} + location=${locationName} + JavaNature="${isSpecifiedNaturePresent}" /> </pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tanthome.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tanthome.html new file mode 100644 index 000000000..91cecf3e6 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tanthome.html @@ -0,0 +1,71 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Extended Ant Support - overview</title> +</head> +<body id="tanthome"><a name="tanthome"><!-- --></a> +<h1 class="topictitle1">Extended Ant Support - overview</h1> +<div><p>You can use the Run ANT option to check your build environment +or use the command line batch file provided for repetitive builds.</p> +<div class="section"><p>In the root of the com.ibm.etools.j2ee.ant plugin is a sample +batch file called runANT.bat. This batch file runs a "headless" workspace, +and it runs a specified ANT script file (example.xml). The ANT script file +must be a fully qualified name.</p> +<p>Edit the runANT.bat file and change +the variables to the correct location for your WebSphere<sup>®</sup> Studio installation. This +file needs to be updated to run this plugin from the command line.</p> +<p>If +you do not specify a build file, runANT will prompt you when you execute the +file. You can then select ANT, list all projects, and quit. When you specify +the build file, it is relative to the project so you must enter project name\buildfile +name. Note that this is case sensitive.</p> +<p>After you list the projects +available, select the ANT option and type in your build filename. You then +need to quit manually when the script is finished or specify another project. +The projects must all be relative to the same workspace.</p> +<p>Also included +is an example.xml file which shows how to use some of the tasks provided through +ANT. Please refer to <samp class="codeph">example.xml</samp> and <samp class="codeph">runANT.bat</samp> for +more information. Note that the tasks themselves are case sensitive but the +parameters available on each task are not.</p> +<p><span class="uicontrol">Hints and Tips</span></p> +<ul><li>When creating an ANT Script, logical order is important. For example, +if you are exporting an Enterprise Application that contains enterprise beans, +you should generate deployment code for your EJB before exporting. Your XML +should look like this: <pre><!-- Run ejbDeploy on the EJB project in an EAR file --> +<ejbDeploy EJBProject="MinibankEJB" IgnoreErrors="true"/> + +<!-- Export the Application project as an EAR file --> +<earExport EARProjectName="MinibankExample" EARExportFile="f:\temp\sample.ear" +ExportSource="true"/></pre> +</li> +<li>If you are using the <samp class="codeph">runAnt.bat</samp> file to do multiple builds, +make sure that change the name of the output in your XML file. If your current +build is incomplete or fails in any way, you still have the previous build +to work from.</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantproj.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantproj.html new file mode 100644 index 000000000..2fa41dd62 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantproj.html @@ -0,0 +1,122 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>projectBuild</title> +</head> +<body id="tantproj"><a name="tantproj"><!-- --></a> +<h1 class="topictitle1">projectBuild</h1> +<div><p>This task builds the specified project.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="22.64808362369338%" id="d0e20">Attribute</th> +<th align="left" valign="top" width="56.79442508710801%" id="d0e22">Description</th> +<th align="left" valign="top" width="20.557491289198605%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">ProjectName</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Name of project to be built</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">BuildType</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Type of build</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>Incremental</em>. Can be <em>Incremental</em> or <em>Full</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">FailOnError</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Whether or not builds should fail on error</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">DebugCompilation</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Whether on not compilations should be debug</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">Quiet (deprecated)</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Whether or not to print out messages</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">ShowErrors</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Whether or not to show the project errors in the ant +build log</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, Default is <em>true</em> </td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">SeverityLevel</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">The problem level to count and treat as a build error</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, Default is <em>ERROR</em>. May be <em>ERROR</em> or + <em>WARNING</em> or <em>INFORMATION</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">CountValidationErrors</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Whether or not to count Validation problems as project +Errors</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, Default is <em>true</em></td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">PropertyCountName</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property to receive the project error count</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, Default is <em>ProjectErrorCount</em> </td> +</tr> +<tr><td align="left" valign="top" width="22.64808362369338%" headers="d0e20 ">PropertyMessagesName</td> +<td align="left" valign="top" width="56.79442508710801%" headers="d0e22 ">Property to receive the project error messages</td> +<td align="left" valign="top" width="20.557491289198605%" headers="d0e24 ">No, Default is <em>ProjectErrorMessages</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Build "myProject". Default is incremental with debug information: <pre><projectBuild ProjectName="myProject" /></pre> +</li> +<li>Do a production build of "myProject", a full build without debug information: <pre><projectBuild +ProjectName="myProject" +failonerror="true" +DebugCompilation="false" +BuildType="full" /> +<echo message="projectBuild: projectName=${projectName} +project Error Count=${ProjectErrorCount} +project Error Messages=${ProjectErrorMessages}" /></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectgeterrors.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectgeterrors.html new file mode 100644 index 000000000..9be23422a --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectgeterrors.html @@ -0,0 +1,111 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>projectGetErrors</title> +</head> +<body id="tantprojectgeterrors"><a name="tantprojectgeterrors"><!-- --></a> +<h1 class="topictitle1">projectGetErrors</h1> +<div><p>This task gets the errors for the specified project. It is a subset +of the projectBuild task (it does not do a build, it just gets project errors +regardless of how they were created)</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e21">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e23">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ProjectName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Name of project to be built </td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not builds should fail if the project contains +any errors</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> false</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ShowErrors</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">The problem level to count and treat as a build error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">SeverityLevel</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether to overwrite if the file already exists.</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> ERROR</em>. May be <em> ERROR</em>, <em> WARNING</em>, +or <em> INFORMATION</em>.</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">CountValidationErrors</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not to count Validation problems as project +Errors</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyCountName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive the project error count</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> ProjectErrorCount</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyMessagesName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive the project error messages</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> ProjectErrorMessages</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Retrieve and display the error+warning count and error+warning messages +for "myProject":<pre><projectGetErrors + ProjectName="myProject" + SeverityLevel="WARNING" + PropertyCountName="myProjectErrorCount + PropertyMessagesName="myProjectErrorMessages" /> +<echo message="projectGetErrors: projectName=${projectName} + project Error+Warning Count=${myProjectErrorCount} + project Error+Warning Messages=${myProjectErrorMessages}" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectimport.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectimport.html new file mode 100644 index 000000000..46187ef0e --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectimport.html @@ -0,0 +1,86 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>projectImport</title> +</head> +<body id="tantprojectimport"><a name="tantprojectimport"><!-- --></a> +<h1 class="topictitle1">projectImport</h1> +<div><p>This task imports an existing file system project into a workspace.</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e21">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e23">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ProjectName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Name of project to be imported</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ProjectLocation</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">The fully qualified location of the project (either under the workspace, +or elsewhere on the file system).</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is <em>${worspaceLocation}/${projectName}</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Import a project which is under the workspace directory, but not presently +in the workspace:<pre><projectImport + ProjectName="myProject"/></pre> +</li> +<li>Import a project which is elsewhere on the file system into the current +workspace:<pre><projectImport + ProjectName="myProject" + ProjectLocation="${MyProjectLocation} /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectsetbuild.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectsetbuild.html new file mode 100644 index 000000000..12ca40f46 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectsetbuild.html @@ -0,0 +1,111 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>projectSetBuild</title> +</head> +<body id="tantprojectsetbuild"><a name="tantprojectsetbuild"><!-- --></a> +<h1 class="topictitle1">projectSetBuild</h1> +<div><p>This task builds a set of Eclipse projects using an existing Eclipse +team Project Set File ("PSF"). The PSF must have been first created using +an Eclipse team "Project Set Export" command, and then the task projectSetImport +must have been used to import those projects into a workspace.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e20">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e22">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">ProjectSetFileName </td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The fully quallified path to the Eclipse PSF file to be +imported</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PropertyBuildProjectNames</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Property to receive a String[] of the names of the projects which were +built</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>BuiltProjectNames</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether on not the Ant build should fail if there is +one or more build errors</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">UseBuildXML</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether or not to use a build.xml (instead of just calling +buildProject for each project)</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">BuildFileName</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Name of an Ant build file</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>build.xml</em> (only used if <em>UseBuildXML=true</em>)</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">BuildTarget </td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Build target within an Ant build file</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>build</em> (only used if <em>UseBuildXML=true</em>)</td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Build using an Eclipse Project Set, and use the Ant task projectBuild +to build each project:<pre><projectSetBuild ProjectSetFileName="${myProjectSet.psf}" /></pre> +</li> +<li>Build using an Eclipse ProjectSet, but use a build.xml file within each +project to do the project builds:<pre><projectSetBuild ProjectSetFileName="${myProjectSet.psf}" + useBuildXML="true" + BuildFileName="build.xml" + BuildTarget="build" + FailOnError="true" + propertyBuiltProjectNames="BuiltProjectNames" /> +<echo message="successful build of projects="${BuildProjectNames}" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectsetimport.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectsetimport.html new file mode 100644 index 000000000..15cb80943 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantprojectsetimport.html @@ -0,0 +1,128 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>projectSetImport</title> +</head> +<body id="tantprojectsetimport"><a name="tantprojectsetimport"><!-- --></a> +<h1 class="topictitle1">projectSetImport</h1> +<div><p>This task imports an existing Eclipse team Project Set File (PSF) +into a workspace. The PSF must have been first created using an Eclipse team +"Project Set Export" command.</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e21">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e23">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ProjectSetFileName </td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">The fully qualified path to the Eclipse PSF file to be +imported</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyImportedProjectNames</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive a String[] of the names of the projects which were +imported</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is <em>ImportedProjectNames</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">AutoDeleteExistingProjects</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not any existing project (with the same name) +will be deleted (replaced) by a new project with the same name</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is <em>true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether on not the Ant build should fail if there is +an import error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is <em>true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">USERID</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">If a CVS PSF is used, and if it contains the string +USERID, then this value is substituted</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PASSWORD</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">If a CVS PSF is used, and if it contains the string +PASSWORD, then this value is substituted</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No</td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Import an Eclipse ProjectSet :<pre><projectSetImport + ProjectSetFileName="${myProjectSet.psf}" /></pre> +</li> +<li>Import an Eclipse ProjectSet that is controlled by a CVS USERID:PASSWORD: <pre><projectSetImport ProjectSetFileName="${myProjectSet.psf}" USERID="${MyCvsUserid}" PASSWORD="${MyCvsPassword}" /></pre> +</li> +<li>Import an Eclipse ProjectSet into a clean workspace but do not replace +any existing project (fail instead):<pre><projectSetImport + ProjectSetFileName="${myProjectSet.psf}" + AutoDeleteExistingProjects="false" + FailOnError="true" /></pre> +</li> +</ul> +<div class="p"><strong>Manually creating a non-team PSF</strong><ul><li>If Eclipse team Source Code Management (SCM) is not being used to store +projects, and they are elsewhere on the file system, then a non-team "Ant" +PSF can be manually created and used to import sets of existing file system +projects. Its internal project reference locations may be either fully qualified, +or relative to the PSF file.</li> +<li>Sample <samp class="codeph">MyAntProjectSet.psf</samp>:<pre><?xml version="1.0" encoding="UTF-8"?> +<psf version="2.0"> +<provider id="antimportProjectSet"> + <project reference="1.0,antimportProjectSet,X:/MyPath/MyProjectDirectory1,MyProjectName1"/> + <project reference="1.0,antimportProjectSet,X:/MyPath/MyProjectDirectory2,MyProjectName2"/> + <project reference="1.0,antimportProjectSet,../MyWorkspaceProjectDir,MyProjectName3"/> + <project reference="1.0,antimportProjectSet,../MyWorkspaceProjectDir,MyProjectName4"/> +</provider> +</psf></pre> +</li> +</ul> +</div> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantsetd.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantsetd.html new file mode 100644 index 000000000..08dd65421 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantsetd.html @@ -0,0 +1,104 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>setDebugInfo</title> +</head> +<body id="tantsetd"><a name="tantsetd"><!-- --></a> +<h1 class="topictitle1">setDebugInfo</h1> +<div><p>This task sets the internal Java™ compilation debug level, and returns +the current settings.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="13.26530612244898%" id="d0e23">Attribute</th> +<th align="left" valign="top" width="40.816326530612244%" id="d0e25">Description</th> +<th align="left" valign="top" width="45.91836734693878%" id="d0e27">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="13.26530612244898%" headers="d0e23 ">DebugInfo</td> +<td align="left" valign="top" width="40.816326530612244%" headers="d0e25 ">Changes all 3 settings</td> +<td align="left" valign="top" width="45.91836734693878%" headers="d0e27 ">No (value unchanged) (may be <em>true</em> or <em>false</em>)</td> +</tr> +<tr><td align="left" valign="top" width="13.26530612244898%" headers="d0e23 ">LineNumber</td> +<td align="left" valign="top" width="40.816326530612244%" headers="d0e25 ">Line Number debug information</td> +<td align="left" valign="top" width="45.91836734693878%" headers="d0e27 ">No (value unchanged) (may be <em>true</em> or <em>false</em>)</td> +</tr> +<tr><td align="left" valign="top" width="13.26530612244898%" headers="d0e23 ">LocalVariable</td> +<td align="left" valign="top" width="40.816326530612244%" headers="d0e25 ">Local Variable symbol table</td> +<td align="left" valign="top" width="45.91836734693878%" headers="d0e27 ">No (value unchanged) (may be <em>true</em> or <em>false</em>)</td> +</tr> +<tr><td align="left" valign="top" width="13.26530612244898%" headers="d0e23 ">SourceFile</td> +<td align="left" valign="top" width="40.816326530612244%" headers="d0e25 ">Source File name</td> +<td align="left" valign="top" width="45.91836734693878%" headers="d0e27 ">No (value unchanged) (may be <em>true</em> or <em>false</em>)</td> +</tr> +<tr><td align="left" valign="top" width="13.26530612244898%" headers="d0e23 ">PropertyName</td> +<td align="left" valign="top" width="40.816326530612244%" headers="d0e25 ">Property Name to receive current settings</td> +<td align="left" valign="top" width="45.91836734693878%" headers="d0e27 ">No, default is <em>DebugInfo</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Retrieve and display current debug info settings: <pre><setDebugInfo /> +<echo message="current settings: ${DebugInfo}" /></pre> +</li> +<li>Set the individual settings to <em>false</em>, then do builds, then set +all settings to <em>true</em>: <pre><setDebugInfo + LineNumber="false" + LocalVariable="false" + sourceFile="false" /> +<echo message="current settings: ${DebugInfo}" /> +... do builds here ... +<setDebugInfo + DebugInfo="true" + PropertyName="Settings" /> +<echo message="current settings: ${Settings}" /></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantutil.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantutil.html new file mode 100644 index 000000000..705256eee --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantutil.html @@ -0,0 +1,79 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>UtilJar</title> +</head> +<body id="tantutil"><a name="tantutil"><!-- --></a> +<h1 class="topictitle1">UtilJar</h1> +<div><p>(DEPRECATED) This task compresses source and/or build output of +a Java™ project +into a JAR file and places the JAR file in an Enterprise Application Project.</p> +<div class="section"><div class="note"><span class="notetitle">Note:</span> This deprecated task was not removed in order to +maintain compatibility with previous versions, but it will be removed in the +future. It should no longer be required; the recommended approach is to use +the application deployment descriptor editor to map Java projects +to utility JARs. </div> +<p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="15.957446808510639%" id="d0e28">Attribute</th> +<th align="left" valign="top" width="61.702127659574465%" id="d0e30">Description</th> +<th align="left" valign="top" width="22.340425531914892%" id="d0e32">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="15.957446808510639%" headers="d0e28 ">EARProjectName</td> +<td align="left" valign="top" width="61.702127659574465%" headers="d0e30 ">Name of the Enterprise Application Project (<em>case sensitive</em>)</td> +<td align="left" valign="top" width="22.340425531914892%" headers="d0e32 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="15.957446808510639%" headers="d0e28 ">JavaProjectName</td> +<td align="left" valign="top" width="61.702127659574465%" headers="d0e30 ">Name of the Java Project (<em>case sensitive</em>)</td> +<td align="left" valign="top" width="22.340425531914892%" headers="d0e32 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="15.957446808510639%" headers="d0e28 ">Jar</td> +<td align="left" valign="top" width="61.702127659574465%" headers="d0e30 ">EAR relative path of the JAR file</td> +<td align="left" valign="top" width="22.340425531914892%" headers="d0e32 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="15.957446808510639%" headers="d0e28 ">IncludeSource</td> +<td align="left" valign="top" width="61.702127659574465%" headers="d0e30 ">Whether to include the source files of the Java Project</td> +<td align="left" valign="top" width="22.340425531914892%" headers="d0e32 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="15.957446808510639%" headers="d0e28 ">Overwrite</td> +<td align="left" valign="top" width="61.702127659574465%" headers="d0e30 ">Whether to overwrite if the file already exists</td> +<td align="left" valign="top" width="22.340425531914892%" headers="d0e32 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Export the project "JProject" with source files to "JProject.jar" and +place the JAR file in EARProject: <pre><utilJar EARProjectName="EARProject" JavaProjectName="JProject" Jar="JProject.jar" IncludeSource="true"/></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antj2ee.html" title="">Ant tasks for J2EE</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantautoappinstall.html" title="This task uses the WebSphere Rapid Deploy feature to install an application.">autoAppInstall</a></div> +<div><a href="../topics/tantappc.html" title="This task performs the same operation as the Application Client export wizard for exporting an Application Client Project to an Application Client JAR file.">AppClientExport</a></div> +<div><a href="../topics/tanteare.html" title="This task performs the same operation as the EAR file export wizard for exporting an Enterprise Application Project to an EAR file.">EARExport</a></div> +<div><a href="../topics/tantware.html" title="This task performs the same operation as the WAR file export wizard for exporting a Web Project to a WAR file.">WARExport</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantware.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantware.html new file mode 100644 index 000000000..1e11dec9c --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantware.html @@ -0,0 +1,71 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>WARExport</title> +</head> +<body id="tantware"><a name="tantware"><!-- --></a> +<h1 class="topictitle1">WARExport</h1> +<div><p>This task performs the same operation as the WAR file export wizard +for exporting a Web Project to a WAR file.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="top" width="17.073170731707318%" id="d0e20">Attribute</th> +<th align="left" valign="top" width="57.3170731707317%" id="d0e22">Description</th> +<th align="left" valign="top" width="25.609756097560975%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">WARProjectName</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Name of the Web Project (<em>case sensitive</em>)</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">WARExportFile</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Absolute path of the WAR file</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">Yes</td> +</tr> +<tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">ExportSource</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Whether to include source files or not</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +<tr><td align="left" valign="top" width="17.073170731707318%" headers="d0e20 ">Overwrite</td> +<td align="left" valign="top" width="57.3170731707317%" headers="d0e22 ">Whether to overwrite if the file already exists</td> +<td align="left" valign="top" width="25.609756097560975%" headers="d0e24 ">No, default is <em>false</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Export the project "ProjectWeb" to "ProjectWeb.war" in the C Drive: <pre><warExport WARProjectName="ProjectWeb" WARExportFile="C:\ProjectWeb.war"/></pre> +</li> +<li>Export the project "ProjectWeb" with the source files to "ProjectWeb.war" +in the C Drive: <pre><warExport WARProjectName="ProjectWeb" WARExportFile="C:\ProjectWeb.war" ExportSource="true"/></pre> +</li> +</ul> +</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antj2ee.html" title="">Ant tasks for J2EE</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantautoappinstall.html" title="This task uses the WebSphere Rapid Deploy feature to install an application.">autoAppInstall</a></div> +<div><a href="../topics/tantappc.html" title="This task performs the same operation as the Application Client export wizard for exporting an Application Client Project to an Application Client JAR file.">AppClientExport</a></div> +<div><a href="../topics/tanteare.html" title="This task performs the same operation as the EAR file export wizard for exporting an Enterprise Application Project to an EAR file.">EARExport</a></div> +<div><a href="../topics/tantutil.html" title="(DEPRECATED) This task compresses source and/or build output of a Java project into a JAR file and places the JAR file in an Enterprise Application Project.">UtilJar</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacebuild.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacebuild.html new file mode 100644 index 000000000..bc4136714 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacebuild.html @@ -0,0 +1,112 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>workspaceBuild</title> +</head> +<body id="tantworkspacebuild"><a name="tantworkspacebuild"><!-- --></a> +<h1 class="topictitle1">workspaceBuild</h1> +<div><p>This task builds the entire workspace.</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e21">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e23">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">BuildType </td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Type of build </td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is <em>Incremental</em>. May be <em>Incremental</em> or <em>Full</em>.</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not builds should fail on error </td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">DebugCompilation</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether on not compilations should be debug </td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ShowErrors</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not to show the project errors in the ant build log</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">SeverityLevel</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">The problem level to count and treat as a build error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> ERROR</em>. May be <em> ERROR</em>, <em> WARNING</em>, +or <em>INFORMATION</em>.</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">CountValidationErrors</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not to count Validation problems as project +Errors</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyCountName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive the project error count</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> WorkspaceErrorCount</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyMessagesName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive the project error messages</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> WorkspaceErrorMessages</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Build the workspace (default is incremental with debug information): <pre><workspaceBuild /></pre> +</li> +<li>Do a production build of workspace (full build without debug information):<pre><workspaceBuild + failonerror="true" + DebugCompilation="false" + BuildType="full"/> +<echo message="projectBuild: projectName=${projectName} + workspace Error Count=${WorkspaceErrorCount} + workspace Error Messages=${WorkspaceErrorMessages}" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacegeterrors.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacegeterrors.html new file mode 100644 index 000000000..687caa1a3 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacegeterrors.html @@ -0,0 +1,106 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>workspaceGetErrors</title> +</head> +<body id="tantworkspacegeterrors"><a name="tantworkspacegeterrors"><!-- --></a> +<h1 class="topictitle1">workspaceGetErrors</h1> +<div><p>This task gets the errors for the entire workspace. It is a subset +of the workspaceBuild task (it does not do a build, it just gets workspace +errors regardless of how they were created).</p> +<div class="section"> <p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e21">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e23">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e25">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not builds should fail if the project contains +any errors</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">ShowErrors</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not to show the project errors in the ant build log</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">SeverityLevel</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">The problem level to count and treat as a build error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> ERROR</em>. May be <em> ERROR</em>, <em> WARNING</em>, +or <em> INFORMATION</em>.</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">CountValidationErrors</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Whether or not to count Validation problems as project +Errors</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyCountName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive the project error count</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> WorkspaceErrorCount</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e21 ">PropertyMessagesName</td> +<td valign="top" width="56.84210526315789%" headers="d0e23 ">Property to receive the project error messages</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e25 ">No, default is<em> WorkspaceErrorMessages</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Retrieve and display the error+warning count and error+warning messages +for "myProject":<pre><workspaceGetErrors + SeverityLevel="WARNING" + PropertyCountName="theWorkspaceErrorCount" + PropertyMessagesName="theWorkspaceErrorMessages" /> +<echo message="workspaceGetErrors: + workspace Error+Warning Count=${theWorkspaceErrorCount} + workspace Error+Warning Messages=${theWorkspaceErrorMessages}" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferencefile.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferencefile.html new file mode 100644 index 000000000..bb52c3674 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferencefile.html @@ -0,0 +1,101 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>workspacePreferenceFile</title> +</head> +<body id="tantworkspacepreferencefile"><a name="tantworkspacepreferencefile"><!-- --></a> +<h1 class="topictitle1">workspacePreferenceFile</h1> +<div><p>This task reads a property file containing Eclipse workspace preferences +and sets those preferences.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e20">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e22">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PreferenceFileName</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The name of the property file containing sorkspace preference </td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">Overwrite</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether or not to overwrite the preference value it it already exists</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether or not the Ant build should fail if there was +an error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Read a preference property file and set its contained workspace preferences:<pre><workspacePreferenceFile + PreferenceFileName="X:/MyPath/MySettings.preferences" + Overwrite="true" + failonerror="true" /></pre> +</li> +<li>Sample <samp class="codeph">MySettings.preferences</samp> file:<pre># +classpathVariable.WAS_51_PLUGINDIR=F:/WAS51/AppServer +# +compiler.problem.unusedImport=ignore +compiler.problem.staticAccessReceiver=ignore +compiler.source=1.4 +# +builder.invalidClasspath=abort +classpath.exclusionPatterns=enabled +# +targetRuntime.runtimeTypeId=com.ibm.etools.websphere.runtime.v51.base +targetRuntime.targetLocation=F:/WAS51/AppServer +targetRuntime.targetName=buildExampleWAS51</pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferenceget.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferenceget.html new file mode 100644 index 000000000..0149087ad --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferenceget.html @@ -0,0 +1,91 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>workspacePreferenceGet</title> +</head> +<body id="tantworkspacepreferenceget"><a name="tantworkspacepreferenceget"><!-- --></a> +<h1 class="topictitle1">workspacePreferenceGet</h1> +<div><p>This task gets Eclipse workspace preferences.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e20">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e22">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PreferenceType</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The type of preference to be set</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes. May be <em>compiler</em> or <em>classpathVariable</em> or <em>classpath</em> or <em>builder</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PreferenceName</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The preference name to be set</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PropertyName</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Property to receive the preference value</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether or not the Ant build should fail if there was +an error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Get and display a workspace preference:<pre><workspacePreferenceGet + preferenceType="compiler" + preferencename="problem.unusedImport" + PropertyName="unusedImport" /> +<echo message="compiler problem.unusedImport=${unusedImport}" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceset.html" title="This task sets Eclipse workspace preferences.">workspacePreferenceSet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferenceset.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferenceset.html new file mode 100644 index 000000000..e4b4bb558 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tantworkspacepreferenceset.html @@ -0,0 +1,111 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + + + + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>workspacePreferenceSet</title> +</head> +<body id="tantworkspacepreferenceset"><a name="tantworkspacepreferenceset"><!-- --></a> +<h1 class="topictitle1">workspacePreferenceSet</h1> +<div><p>This task sets Eclipse workspace preferences.</p> +<div class="section"><p><span class="uicontrol">Parameters</span></p> + +<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="21.052631578947366%" id="d0e20">Attribute</th> +<th valign="top" width="56.84210526315789%" id="d0e22">Description</th> +<th align="left" valign="top" width="22.105263157894736%" id="d0e24">Required</th> +</tr> +</thead> +<tbody><tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PreferenceType</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The type of preference to be set</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes. May be <em>compiler</em> or <em>classpathVariable</em> or <em>classpath</em> or <em>builder</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PreferenceName</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The preference name to be set</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">PreferenceValue</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">The value to be set</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">Yes</td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">Overwrite</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether or not to overwrite the preference value it +it already exists</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +<tr><td valign="top" width="21.052631578947366%" headers="d0e20 ">FailOnError</td> +<td valign="top" width="56.84210526315789%" headers="d0e22 ">Whether or not the Ant build should fail if there was +an error</td> +<td align="left" valign="top" width="22.105263157894736%" headers="d0e24 ">No, default is <em>true</em></td> +</tr> +</tbody> +</table> +</div> +<p><span class="uicontrol">Examples</span></p> +<ul><li>Set various workspace preferences:<pre><workspacePreferenceSet + PreferenceType="compiler" + Preferencename="problem.unusedImport" + PreferenceValue="ignore" /> +<workspacePreferenceSet + PreferenceType="compiler" + Preferencename="problem.staticAccessReceiver" + PreferenceValue="ignore" /> +<workspacePreferenceSet + PreferenceType="classpathVariable" + Preferencename="WAS_PLUGINDIR" + PreferenceValue="F:/Wte51/AppServer" /> +<workspacePreferenceSet + PreferenceType="classpath" + Preferencename="exclusionPatterns" + PreferenceValue="enabled" /> +<workspacePreferenceSet + PreferenceType="builder" + Preferencename="invalidClasspath" + PreferenceValue="abort" /></pre> +</li> +</ul> + </div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-antgeneral.html" title="">General Ant tasks</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tantcapturebuildmessages.html" title="This task captures Ant build messages and allows them to be searched or displayed, and allows conditional Ant build failures depending on whether or not a specified string is in the captured build messages.">captureBuildMessages</a></div> +<div><a href="../topics/tantcompilew.html" title="This task compiles the entire workspace. It performs the same action as javac. While this task is running, all the validation and other builders are turned of">compileWorkspace</a></div> +<div><a href="../topics/tantgetj.html" title="This task gets the error count for the last internal javac compilation of the specified project.">getJavacErrorCount</a></div> +<div><a href="../topics/tantgetp.html" title="This task gets the specified project information.">getProjectData</a></div> +<div><a href="../topics/tantproj.html" title="This task builds the specified project.">projectBuild</a></div> +<div><a href="../topics/tantprojectgeterrors.html" title="This task gets the errors for the specified project. It is a subset of the projectBuild task (it does not do a build, it just gets project errors regardless of how they were created)">projectGetErrors</a></div> +<div><a href="../topics/tantprojectimport.html" title="This task imports an existing file system project into a workspace.">projectImport</a></div> +<div><a href="../topics/tantprojectsetbuild.html" title="This task builds a set of Eclipse projects using an existing Eclipse team Project Set File ("PSF"). The PSF must have been first created using an Eclipse team "Project Set Export" command, and then the task projectSetImport must have been used to import those projects into a workspace.">projectSetBuild</a></div> +<div><a href="../topics/tantprojectsetimport.html" title="This task imports an existing Eclipse team Project Set File (PSF) into a workspace. The PSF must have been first created using an Eclipse team "Project Set Export" command.">projectSetImport</a></div> +<div><a href="../topics/tantsetd.html" title="This task sets the internal Java compilation debug level, and returns the current settings.">setDebugInfo</a></div> +<div><a href="../topics/tantworkspacebuild.html" title="This task builds the entire workspace.">workspaceBuild</a></div> +<div><a href="../topics/tantworkspacegeterrors.html" title="This task gets the errors for the entire workspace. It is a subset of the workspaceBuild task (it does not do a build, it just gets workspace errors regardless of how they were created).">workspaceGetErrors</a></div> +<div><a href="../topics/tantworkspacepreferencefile.html" title="This task reads a property file containing Eclipse workspace preferences and sets those preferences.">workspacePreferenceFile</a></div> +<div><a href="../topics/tantworkspacepreferenceget.html" title="This task gets Eclipse workspace preferences.">workspacePreferenceGet</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjant.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjant.html new file mode 100644 index 000000000..c5fb7926e --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjant.html @@ -0,0 +1,110 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Working with Ant</title> +</head> +<body id="tjant"><a name="tjant"><!-- --></a> +<h1 class="topictitle1">Working with Ant</h1> +<div><div class="section"> <p>Ant support is provided as a built-in feature of the workbench. +If you right-click any XML file and select <span class="uicontrol">Run Ant</span> from +the pop-up menu, the Execute Ant Script dialog shows the available Ant targets. +You can check, in sequence, which ones are to be executed, and the execution +sequence will be shown beside each target. You can also select <span class="uicontrol">Display +execution log to Ant console</span>, which will cause any Ant messages +to be displayed in the Ant Console view (<span class="uicontrol">Perspective</span><span class="uicontrol">Show +View</span><span class="uicontrol">Other</span><span class="uicontrol">Ant</span><span class="uicontrol">Ant +Console</span>).</p> +<p>In addition, an Arguments field lets you pass +arguments, such as <samp class="codeph">-verbose</samp>, to the Ant program. If the Ant +script invokes the Ant <samp class="codeph">javac</samp> task, then a special <samp class="codeph">-Dbuild.compiler=org.eclipse.pde.internal.core.JDTCompilerAdapter</samp> argument must be passed or you will get a <samp class="codeph">Cannot use classic compiler</samp> error. </p> +<p>If +you use the the <samp class="codeph">deprecation="on"</samp> option for the <samp class="codeph">javac</samp> Ant +task, WebSphere<sup>®</sup> Studio +will crash. You should either specify nothing or use <tt>deprecation="off"</tt>.</p> +</div> +<ol><li class="stepexpand"><span>Create the following <samp class="codeph">echo.xml</samp> file inside any +project in your workspace:</span> <pre><?xml version="1.0"?> + <project name="Echo" default="echo" basedir="."> + <target name="echo"> + <echo message="HELLO from echo"/> + </target> + <target name="dir"> + <echo message="dir of ${basedir}:"/> + <exec dir="${basedir}" executable="cmd.exe"> + <arg line="/c dir"/> + </exec> + </target> + </project></pre> +</li> +<li class="stepexpand"><span>Right-click <samp class="codeph">echo.xml</samp> and select <span class="uicontrol">Run +Ant</span>.</span></li> +<li class="stepexpand"><span>The Run Ant dialog shows that you have two targets, echo and dir, +and that echo[1] is the default target that will be executed. If you also +select dir, it will change to dir[2] and it will be run as the second target. +Ensure that <span class="uicontrol">Display execution log to Ant console</span> is +checked and click <span class="uicontrol">Finish</span>. The script will then be run.</span> The results are displayed in the Ant Console.</li> +<li class="stepexpand"><span>Right-click <samp class="codeph">echo.xml</samp> and select <span class="uicontrol">Run +Ant</span> to run it again. This time enter <tt>-verbose</tt> in the +arguments entry field, then click <span class="uicontrol">Finish</span>.</span></li> +</ol> +<div class="example">Try editing your <samp class="codeph">echo.xml</samp> file to include the following <samp class="codeph">bad</samp> target +with a nonexistent task <samp class="codeph">propertyBad</samp>:<pre><target name="bad"> + <propertyBAD name="MyName" value="MyValue"/> +</target></pre> +<p>Right-click <samp class="codeph">echo.xml</samp> and select <span class="uicontrol">Run +Ant</span> to run it again. Select <span class="uicontrol">bad</span> as your +target and click <span class="uicontrol">Finish</span>. You will receive the following +error message, listed twice: "Could not create task of type: <samp class="codeph">propertyBad</samp>" +in the Problems view. You can partly fix this by changing <samp class="codeph">propertyBad</samp> to +property, and then saving <samp class="codeph">echo.xml</samp>. The errors in the Task +view will remain, because the errors are Ant runtime errors. If you run Ant +again, the error messages will disappear.</p> +</div> +</div> +<div> +<ul class="ullinks"> +<li class="ulchildlink"><strong><a href="../topics/cjant.html">Ant support</a></strong><br /> +This topic provides an overview of the Ant support provided in +the workbench.</li> +<li class="ulchildlink"><strong><a href="../topics/tanthome.html">Extended Ant Support - overview</a></strong><br /> +You can use the Run ANT option to check your build environment +or use the command line batch file provided for repetitive builds.</li> +<li class="ulchildlink"><strong><a href="../topics/tjantheadless.html">Running Ant in a headless workspace</a></strong><br /> +You can use Ant to run a workbench with no interface and run specified +Ant scripts.</li> +<li class="ulchildlink"><strong><a href="../topics/tjantupgrade.html">Upgrading Ant</a></strong><br /> +Ant 1.6.1 is provided with this product. If you need +functionality from a different version of Ant, you can download and install +an updated version.</li> +<li class="ulchildlink"><strong><a href="../topics/ph-antgeneral.html">General Ant tasks</a></strong><br /> +</li> +<li class="ulchildlink"><strong><a href="../topics/ph-antj2ee.html">Ant tasks for J2EE</a></strong><br /> +</li> +<li class="ulchildlink"><strong><a href="../topics/ph-antejb.html">Ant tasks for EJB-enabled tools</a></strong><br /> +</li> +<li class="ulchildlink"><strong><a href="../topics/tantexampleautobuild.html">Example: Automated Ant build</a></strong><br /> +This example program shows a typical automated build using the +workbench Ant tasks.</li> +<li class="ulchildlink"><strong><a href="../topics/tantexampleautodeploy.html">Example: Automated Ant deploy</a></strong><br /> +This example program shows a typical automated deployment using +the WebSphere Application +Server Ant tasks.</li> +</ul> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjantheadless.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjantheadless.html new file mode 100644 index 000000000..c901b6942 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjantheadless.html @@ -0,0 +1,59 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Running Ant in a headless workspace</title> +</head> +<body id="tjantheadless"><a name="tjantheadless"><!-- --></a> +<h1 class="topictitle1">Running Ant in a headless workspace</h1> +<div><p>You can use Ant to run a workbench with no interface and run specified +Ant scripts.</p> +<div class="section"> <p>In the root of the com.ibm.etools.j2ee.ant plugin is a sample +batch file called <samp class="codeph">runANT.bat</samp>. This <samp class="codeph">.bat</samp> file +will run a "headless" workbench (no user interface for the development environment) +and run a specified ANT script file (<samp class="codeph">example.xml</samp>). The ANT +script file must be a fully qualified name.</p> +<div class="p">Using runAnt has two advantages +over the org.eclipse.ant.core.antRunner application: <ul><li>The workspace is saved after executing the specified build file.</li> +<li>Autobuild is disabled during Ant script execution as a performance enhancement +and to fix a known limitation with org.eclipse.ant.core.antRunner on Linux<sup>®</sup>.</li> +</ul> +</div> +</div> +<ol><li class="stepexpand"><span>If you run runAnt with no parameters, it will present a simple +menu of operations.</span><ul><li>List your workbench projects</li> +<li>Run an Ant script</li> +</ul> +</li> +<li class="stepexpand"><span>If you specify parameters, it will pass them to Ant inside the +workbench. Try the following command:</span> <pre>runAnt -buildfile x:\MYWORKSPACE\MYPROJECT\echo.xml echo dir</pre> +</li> +<li class="stepexpand"><span>Then try the command:</span> <pre>runAnt</pre> +</li> +<li class="stepexpand"><span>Then, you can type either <kbd class="userinput">1</kbd> or <kbd class="userinput">2</kbd> plus +the following:</span> <pre>-buildfile x:\MYWORKSPACE\MYPROJECT\echo.xml</pre> +</li> +</ol> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjantupgrade.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjantupgrade.html new file mode 100644 index 000000000..995663065 --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjantupgrade.html @@ -0,0 +1,50 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Upgrading Ant</title> +</head> +<body id="tjantupdgrade"><a name="tjantupdgrade"><!-- --></a> +<h1 class="topictitle1">Upgrading Ant</h1> +<div><p>Ant 1.6.1 is provided with this product. If you need +functionality from a different version of Ant, you can download and install +an updated version.</p> +<div class="section"> <div class="cautiontitle">CAUTION:</div><div class="caution">If you change your Ant version, you have changed +your installation of the workbench, and it will no longer be a supported environment. +Although everything should still work as before, unexpected results may occur. +If you are familiar with developing plug-ins and understand how they are used +during startup, you can create a new plug-in directory with a higher version +number and a higher version number in its <samp class="codeph">plugin.xml</samp>, and +you can leave the existing directory as is.</div> +</div> +<ol><li><span>Go to the <a href="http://jakarta.apache.org/site/binindex.html" target="_blank">Jakarta Apache</a> Web site and download +the Ant binary distribution that you want.</span></li> +<li><span>In the <samp class="codeph">org.eclipse.ant.core</samp> plugin directory (underneath +where you installed the workbench), rename the existing Ant JAR files and +drop in your new JAR files. If any JAR has a different name edit the <samp class="codeph">plugin.xml</samp> file +in <samp class="codeph">org.eclipse.ant.core</samp> accordingly.</span></li> +<li><span>Restart the workbench and your new version of Ant will be active.</span></li> +</ol> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tjant.html">Working with Ant</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjappproj.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjappproj.html index 0d4561bb7..d3a8d7fa6 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjappproj.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjappproj.html @@ -4,7 +4,6 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -15,11 +14,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Creating an application client project</title> </head> <body id="tjappproj"><a name="tjappproj"><!-- --></a> - <h1 class="topictitle1">Creating an application client project</h1> <div><p>You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.</p> @@ -29,7 +28,7 @@ run on networked client systems. An application client project is deployed as a JAR file.</p> <p>To create a J2EE application client project:</p> </div> -<ol><li class="stepexpand"><span>In the J2EE perspective, select <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">New</span> > <span class="uicontrol">Application Client Project</span></span>.</span></li> +<ol><li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">New</span> > <span class="uicontrol">Application Client Project</span></span>. The New Application Client Project window opens.</span></li> <li class="stepexpand"><span>In the <span class="uicontrol">Name</span> field, type a name for the application client project. </span></li> <li class="stepexpand"><span>To change the default <span class="uicontrol">Project location</span>, @@ -37,35 +36,38 @@ click the <span class="uicontrol">Browse</span> button to select a new location. you specify a non-default project location that is already being used by another project, the project creation will fail.</span></li> <li class="stepexpand"><span>Click <span class="uicontrol">Show Advanced</span>.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Target server</span> list, select the application -server that you want to target for your development. This selection affects -the run time settings by modifying the class path entries for the project.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Module version</span> list, select -the J2EE specification level to which you want your application client project -to adhere.</span></li> -<li class="stepexpand"><span>If you want to add the new module to an enterprise application -(EAR) project, select the <span class="uicontrol">Add module to an EAR application</span> check -box.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">EAR application</span> list, type a new -project name or select an existing enterprise application project. Or, click -the <span class="uicontrol">New</span> button to launch the New Enterprise Application -Project wizard.</span> <div class="note"><span class="notetitle">Note: </span>If you type a new EAR project name, the EAR -project will be created in the default location with the lowest compatible -J2EE version based on the version of the project being created. If you want -to specify a different version or a different location for the enterprise -application, you must use the New Enterprise Application Project wizard.</div> +<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> drop-down list, select +the application server that you want to target for your development. This +selection affects the run time settings by modifying the class path entries +for the project.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Module version</span> drop-down list, select +the module version to which you want your application client project to adhere.</span></li> +<li class="stepexpand"><span>Specify whether you want to add the new module to an enterprise +application (EAR) project.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">EAR application</span> combination box, +type a new project name or select an existing enterprise application project +from the drop-down list. Or, click the <span class="uicontrol">New</span> button to +launch the New Enterprise Application Project wizard.</span> <div class="note"><span class="notetitle">Note:</span> If +you type a new EAR project name, the EAR project will be created in the default +location with the lowest compatible J2EE version based on the version of the +project being created. If you want to specify a different version or a different +location for the enterprise application, you must use the New Enterprise Application +Project wizard.</div> </li> <li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li> </ol> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<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 class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> <div><a href="../topics/cjappcliproj.html">Application client projects</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjexpapp.html" title="You can export an application client project as a JAR file.">Exporting an application client project</a></div> -<div><a href="../topics/tjimpapp.html">Importing an application client JAR file</a></div> -</div> +<div><a href="../topics/tjimpapp.html" title="Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.">Importing an application client JAR file</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjcircleb.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjcircleb.html index a545ecfe3..af9b2f35c 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjcircleb.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjcircleb.html @@ -14,11 +14,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Correcting cyclical dependencies after an EAR is imported</title> </head> <body id="tjcircleb"><a name="tjcircleb"><!-- --></a> - <h1 class="topictitle1">Correcting cyclical dependencies after an EAR is imported</h1> <div><p>You can resolve cyclical dependencies after an EAR is imported.</p> <div class="section">A cyclical dependency between two or more modules in an enterprise @@ -34,13 +34,22 @@ of producing a better factored and layered application.</p> <ol><li><span>Identify all the classes within the JAR files that have cyclical dependencies, then move those classes into a common Java project or JAR file.</span></li> -<li><span>Map utility JAR files to the common projects.</span></li> -<li><span>Set dependencies only to the JAR files that are truly required.</span></li> +<li><span>Use the enterprise application editor to map utility JAR files +to the common projects.</span></li> +<li><span>Use the JAR dependency editor or properties page, for each module +of the JAR in the application, to set dependencies only to the JAR files that +are truly required.</span></li> </ol> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +<div class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjcircle.html">Cyclical dependencies between J2EE modules</a></div> </div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjear.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjear.html index c39819c6b..f3b6026c7 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjear.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjear.html @@ -14,13 +14,13 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Creating an enterprise application project</title> </head> <body id="tjear"><a name="tjear"><!-- --></a> - <h1 class="topictitle1">Creating an enterprise application project</h1> -<div><div class="section"> <p>Enterprise application projects contain references to the resources +<div><div class="section"><p>Enterprise application projects contain references to the resources needed for enterprise applications and can contain a combination of Web modules, JAR files, connector modules, EJB modules, and application client modules. An enterprise application project is deployed in the form of an EAR file, @@ -39,20 +39,19 @@ create a J2EE enterprise application project:</p> <li class="stepexpand"><span>In the <span class="uicontrol">Name</span> field, type a name for the new enterprise application project. To change the default <span class="uicontrol">Project location</span>, click the <span class="uicontrol">Browse</span> button to select a new location.</span></li> -<li class="stepexpand"><span>Click <span class="uicontrol">Show Advanced</span> to specify the target -server and module version for the enterprise application.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Target server</span> list, select +<li class="stepexpand"><span>Click <span class="uicontrol">Show Advanced</span>.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> drop-down list, select the application server that you want to target for your development. </span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Module version</span> list, specify -the J2EE specification level that you want to use for this enterprise application.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Module Version</span> list, specify the +J2EE specification level that you want to use for this enterprise application.</span></li> <li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> -<li class="stepexpand"><span>On the J2EE Modules to Add to the EAR page, select the existing -modules that you want to add to the new enterprise application project. Click -the <span class="uicontrol">New Module</span> button to open another wizard that can -create new modules for this enterprise application. In the New -Module wizard, if you select the <span class="uicontrol">Create default module projects</span> check -box, you can choose to create default versions of the following modules which -will be compatible with the enterprise application J2EE version:</span><ul><li>Application client project</li> +<li class="stepexpand"><span>On the EAR Modules page of the wizard, select the existing modules +that you want to add to the new enterprise application project. Click the <span class="uicontrol">New +Module</span> button to open another wizard where you can create new +modules for this enterprise application. In the New Module wizard, if you +select the <span class="uicontrol">Create default module projects</span> check box, +you can choose to create default versions of the following modules which will +be compatible with the enterprise application J2EE version:</span><ul><li>Application client project</li> <li>EJB project</li> <li>Web project</li> <li>Connector project</li> @@ -71,13 +70,17 @@ you are creating.</p> <li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li> </ol> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<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 class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> <div><a href="../topics/cjearproj.html" title="An enterprise application project contains the hierarchy of resources that are required to deploy a J2EE enterprise application, often referred to as an EAR file.">Enterprise application projects</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div> <div><a href="../topics/tjexpear.html" title="Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.">Exporting an enterprise application into an EAR file</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpapp.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpapp.html index e17e963da..2ad3dd9fb 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpapp.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpapp.html @@ -14,43 +14,42 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Exporting an application client project</title> </head> <body id="tjexpapp"><a name="tjexpapp"><!-- --></a> - <h1 class="topictitle1">Exporting an application client project</h1> <div><p>You can export an application client project as a JAR file.</p> <div class="section"><p>To export an application client project from the workbench:</p> </div> <ol><li><span>In the Project Explorer view of the J2EE perspective, right-click the application client project that you want to export.</span></li> -<li><span>Click <span class="menucascade"><span class="uicontrol">Export</span></span>. -The Export wizard opens.</span></li> -<li><span>Under <span class="uicontrol">Select an export destination</span>, click <span class="uicontrol">App -Client JAR file</span>.</span></li> -<li><span>Click <span class="uicontrol">Next</span>.</span></li> -<li><span>In the <span class="uicontrol">Application Client project</span> list, -select the project to export.</span></li> +<li><span>Select <span class="menucascade"><span class="uicontrol">Export</span> > <span class="uicontrol">App +Client JAR file</span></span> from the pop-up menu. The Export +wizard opens.</span></li> <li><span>In the <span class="uicontrol">Destination</span> field, enter the full path and JAR file name where you want to export the application client project -that is selected in the <span class="uicontrol">Application Client project</span> list.</span></li> +that is selected in the <span class="uicontrol">Application Client project</span> field.</span></li> <li><strong>Optional: </strong><span>To export source files, select the <span class="uicontrol">Export source files</span> check box.</span></li> <li><strong>Optional: </strong><span>If you are exporting to an existing JAR file and you do not want to be warned about overwriting it, select <span class="uicontrol">Overwrite -existing files without warning</span></span></li> +existing files without warning</span>.</span></li> <li><span>Click <span class="uicontrol">Finish</span>.</span></li> </ol> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +<div class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> <div><a href="../topics/cjappcliproj.html">Application client projects</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjappproj.html" title="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.">Creating an application client project</a></div> -<div><a href="../topics/tjimpapp.html">Importing an application client JAR file</a></div> -</div> +<div><a href="../topics/tjimpapp.html" title="Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.">Importing an application client JAR file</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpear.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpear.html index a382d72ae..d1e32ca33 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpear.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexpear.html @@ -14,35 +14,39 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Exporting an enterprise application into an EAR file</title> </head> <body id="tjexpear"><a name="tjexpear"><!-- --></a> - <h1 class="topictitle1">Exporting an enterprise application into an EAR file</h1> <div><p>Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.</p> <div class="section"> <p>To export an enterprise application project into an EAR file:</p> </div> -<ol><li><span>In the Project Explorer view of the J2EE perspective, right-click +<ol><li class="stepexpand"><span>In the Project Explorer view of the J2EE perspective, right-click the project that you want to export.</span></li> -<li><span>Click <span class="menucascade"><span class="uicontrol">Export</span></span>. -The Export wizard opens.</span></li> -<li><span>Under <span class="uicontrol">Select an export destination</span>, click <span class="uicontrol">EAR +<li class="stepexpand"><span>Click <span class="uicontrol">Export</span> from the pop-up menu. The Export +wizard opens.</span></li> +<li class="stepexpand"><span>Under <span class="uicontrol">Select an export destination</span>, click <span class="uicontrol">EAR file</span>.</span></li> -<li><span>Click <span class="uicontrol">Next</span>.</span></li> -<li><span>In the <span class="uicontrol">EAR Application</span> list, select the +<li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">EAR Application</span> list, select the project to export.</span></li> -<li><span>In the <span class="uicontrol">Destination</span> field, enter the full +<li class="stepexpand"><span>In the <span class="uicontrol">Destination</span> field, enter the full path and EAR file name where you want to export the enterprise application -project that is selected in the <span class="uicontrol">EAR Application</span> field.</span></li> -<li><strong>Optional: </strong><span>To export source files, select the <span class="uicontrol">Export +project that is selected in the <span class="uicontrol">EAR application</span> field.</span></li> +<li class="stepexpand"><strong>Optional: </strong><span>To export source files, select the <span class="uicontrol">Export source files</span> check box.</span></li> -<li><strong>Optional: </strong><span>If you are exporting to an existing EAR file +<li class="stepexpand"><strong>Optional: </strong><span>If you are exporting to an existing EAR file and you do not want to be warned about overwriting it, select <span class="uicontrol">Overwrite existing files without warning</span></span></li> -<li><span>Click <span class="uicontrol">Finish</span>.</span></li> +<li class="stepexpand"><strong>Optional: </strong><span>Select <span class="uicontrol">Include project build paths +and meta-data files</span>.</span> This allows you to preserve the +original names of projects included in or referenced by the application project, +for re-importing the EAR in another workspace. </li> +<li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li> </ol> <div class="section">The wizard exports the contents of the EAR project to the specified EAR file. Additionally, for each project that corresponds to a module or utility @@ -51,13 +55,17 @@ or JAR file in the EAR file. If any unsaved changes exist on any of the files in any of the referenced projects, you are prompted to save these files prior to export.</div> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +<div class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> <div><a href="../topics/cjearproj.html" title="An enterprise application project contains the hierarchy of resources that are required to deploy a J2EE enterprise application, often referred to as an EAR file.">Enterprise application projects</a></div> </div> <div class="reltasks"><strong>Related tasks</strong><br /> <div><a href="../topics/tjear.html">Creating an enterprise application project</a></div> +<div><a href="../topics/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexprar.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexprar.html new file mode 100644 index 000000000..2d2aa48fb --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjexprar.html @@ -0,0 +1,52 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Exporting connector projects to RAR files</title> +</head> +<body id="tjexprar"><a name="tjexprar"><!-- --></a> +<h1 class="topictitle1">Exporting connector projects to RAR files</h1> +<div><p>You can export a connector project to a RAR file in preparation +for deploying it to a server.</p> +<div class="section"> <p>To export the contents of a connector project to +a RAR file:</p> +</div> +<ol><li><span>In the Project Explorer view of the J2EE perspective, right-click +the connector project that you want to export and click <span class="uicontrol">Export</span>.</span></li> +<li><span>In the Export window, click <span class="uicontrol">RAR file</span>.</span></li> +<li><span>Click <span class="uicontrol">Next</span>.</span></li> +<li><span>In the <span class="uicontrol">Connector module</span> list, select the +name of the connector project to export.</span></li> +<li><span>In the <span class="uicontrol">Destination</span> field, enter the full +path and RAR file name where you want to export the module that is selected +in the <span class="uicontrol">Connector project</span> field.</span></li> +<li><strong>Optional: </strong><span>To export source files, select the <span class="uicontrol">Export +source files</span> check box.</span></li> +<li><strong>Optional: </strong><span>If you are exporting to an existing RAR file +and you do not want to be warned about overwriting it, select <span class="uicontrol">Overwrite +existing file</span></span></li> +<li><span>Click <span class="uicontrol">Finish</span>.</span></li> +</ol> +<div class="section"> The wizard exports the contents of the RAR project to the specified +RAR file.</div> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpapp.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpapp.html index cbc43aebb..435e39f6f 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpapp.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpapp.html @@ -14,55 +14,59 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Importing an application client JAR file</title> </head> <body id="tjimpapp"><a name="tjimpapp"><!-- --></a> - <h1 class="topictitle1">Importing an application client JAR file</h1> -<div><div class="section"> <p>Application client projects are deployed as JAR files. You can +<div><p>Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.</p> -<p>To import an application client JAR file -using the wizard:</p> +<div class="section"> <p>To import an application client JAR file using the wizard:</p> </div> -<ol><li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">Import</span></span>. The Import wizard opens.</span></li> +<ol><li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">Import</span></span>. The Import window opens.</span></li> <li class="stepexpand"><span>Under <span class="uicontrol">Select an import source</span>, click <span class="uicontrol">App -Client JAR file</span>.</span></li> +Client Jar file</span>.</span></li> <li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Application Client file</span> combination -box, enter the location and name of the application client JAR file that you -want to import. Click the <span class="uicontrol">Browse</span> button to select the -JAR file from the file system.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Application Client project</span> combination -box, type a name for a new project or select an application client project -from the list. Or, click the <span class="uicontrol">New</span> button to -launch the New Application Client Project wizard. If you type a new name in -this field, the application client project will be created based on the version -of the application client JAR file, and it will use the default location. -Use the <span class="uicontrol">New</span> button to change the J2EE version and the -location.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Target server</span> list, select +<li class="stepexpand"><span>In the <span class="uicontrol">Application Client file</span> field, enter +the location and name of the application client JAR file that you want to +import. Click the <span class="uicontrol">Browse</span> button to select the JAR file +from the file system.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Application Client project</span> field, +type a new project or select an application client project from the drop-down +list. Or, click the <span class="uicontrol">New</span> button to launch the New Application +Client Project wizard. If you type a new name in this field, the application +client project will be created based on the version of the application client +JAR file, and it will use the default location. Use the <span class="uicontrol">New</span> button +to change the J2EE version and the location.</span></li> +<li class="stepexpand"><span>If you are importing to an existing project, select <span class="uicontrol">Overwrite +existing resources without warning</span>.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Target server</span> drop-down list, select the application server that you want to target for your development. This selection affects the run time settings by modifying the class path entries for the project.</span></li> -<li class="stepexpand"><span>If you want to add the imported project to an enterprise application -(EAR) project, select the <span class="uicontrol">Add module to an EAR application</span> check -box.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">EAR application</span> list, type a new -project name or select an existing enterprise application project. Or, click -the <span class="uicontrol">New</span> button to launch the New Enterprise Application -Project wizard.</span> <div class="note"><span class="notetitle">Note: </span>If you type a new EAR project name, the EAR -project will be created in the default location with the lowest compatible -J2EE version based on the version of the project being created. If you want -to specify a different version or a different location for the enterprise -application, you must use the New Enterprise Application Project wizard.</div> +<li class="stepexpand"><span>Specify whether you want to add the new module to an enterprise +application (EAR) project.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">EAR application</span> field, type a new +project name or select an existing enterprise application project from the +drop-down list. Or, click the <span class="uicontrol">New</span> button to launch +the New Enterprise Application Project wizard.</span> <div class="note"><span class="notetitle">Note:</span> If you type +a new EAR project name, the EAR project will be created in the default location +with the lowest compatible J2EE version based on the version of the project +being created. If you want to specify a different version or a different location +for the enterprise application, you must use the New Enterprise Application +Project wizard.</div> </li> <li class="stepexpand"><span>Click <span class="uicontrol">Finish</span> to import the application client JAR file.</span></li> </ol> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +<div class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> <div><a href="../topics/cjappcliproj.html">Application client projects</a></div> </div> @@ -70,6 +74,5 @@ JAR file.</span></li> <div><a href="../topics/tjappproj.html" title="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.">Creating an application client project</a></div> <div><a href="../topics/tjexpapp.html" title="You can export an application client project as a JAR file.">Exporting an application client project</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpear.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpear.html index ac7d9c392..3b6118b18 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpear.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimpear.html @@ -14,52 +14,49 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Importing an enterprise application EAR file</title> </head> <body id="tjimpear"><a name="tjimpear"><!-- --></a> - <h1 class="topictitle1">Importing an enterprise application EAR file</h1> -<div><div class="section"> <p>Enterprise application projects are deployed into EAR files. -You can import an enterprise application project by importing it from a deployed +<div><p>Enterprise application projects are deployed into EAR files. You +can import an enterprise application project by importing it from a deployed EAR file.</p> -<p>You can also choose to import utility JAR files as utility Java™ projects. +<div class="section"> <p>You can also choose to import utility JAR files as utility Java™ projects. You can also use the wizard to change the new project names for the EAR file and modules that will be imported.</p> <p>To import an EAR file using the wizard:</p> </div> -<ol><li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">Import</span></span>. The Import wizard opens.</span></li> -<li class="stepexpand"><span>Under <span class="uicontrol">Select an import source</span>, click <span class="uicontrol">EAR -file</span>.</span></li> +<ol><li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">Import</span></span>. The Import window opens.</span></li> +<li class="stepexpand"><span>Click <span class="uicontrol">EAR file</span>.</span></li> <li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> <li class="stepexpand"><span>Specify the following general options for the EAR import:</span> <ol type="a"><li><span><span class="uicontrol">EAR file</span>: Enter the full path for the EAR file that you want to import. You can click <span class="uicontrol">Browse</span> to select the EAR file from the file system.</span></li> <li><span><span class="uicontrol">EAR project</span>: type a name for the enterprise application project that will be created when you import the EAR file.</span></li> -<li><span><span class="uicontrol">Target server</span>: Select the application +<li><span><span class="uicontrol">Target runtime</span>: Select the application server that you want to target for your development. This selection affects the runtime settings by modifying the class path entries for the project.</span></li> </ol> </li> -<li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> -<li class="stepexpand"><span>On the Enterprise Application Import page, select any utility JAR -files from the project that you want to import as utility projects.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Module Root Location</span> field, specify +<li class="stepexpand"><span>Click <span class="uicontrol">Next</span>, and complete the following steps:</span><ol type="a"><li><span>On the Enterprise Application Import page, select any utility +JAR files from the project that you want to import as utility projects.</span></li> +<li><span>In the <span class="uicontrol">Module Root Location field</span>, specify the root directory for all of the projects that will be imported or created during import.</span></li> +</ol> +</li> <li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> <li class="stepexpand"><span>On the EAR Module and Utility JAR Projects page of the wizard, select the projects that you want to import with the EAR file. Also, you can -edit the new project name for each module and utility project to be imported.</span> <div class="tip"><span class="tiptitle">Tip: </span>The selection buttons on this page can help you select +edit the new project name for each module and utility project to be imported.</span> <div class="tip"><span class="tiptitle">Tip:</span> The selection buttons on this page can help you select the projects to import when you are importing for partial EAR development. For example, if you are importing to a workspace where some projects are attached to a repository and other projects are in binary form, these buttons help you make the proper selections for which projects to import:<ul><li><span class="uicontrol">Select New</span>: Selects the projects that are currently not in your workspace.</li> -<li><span class="uicontrol">Select Binary</span>: Selects the modules and projects -that currently exist in the workspace in binary form. This can help you avoid -overwriting your non-binary projects that are attached to a repository.</li> <li><span class="uicontrol">Select All</span>: Selects all projects for import.</li> <li><span class="uicontrol">Deselect All</span>: Clears all module and utility projects for import.</li> @@ -70,6 +67,19 @@ for import.</li> EAR file.</span></li> </ol> </div> -<div></div> -</body> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +<div class="relconcepts"><strong>Related concepts</strong><br /> +<div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> +<div><a href="../topics/cjearproj.html" title="An enterprise application project contains the hierarchy of resources that are required to deploy a J2EE enterprise application, often referred to as an EAR file.">Enterprise application projects</a></div> +<div><a href="../topics/cjcircle.html">Cyclical dependencies between J2EE modules</a></div> +</div> +<div class="reltasks"><strong>Related tasks</strong><br /> +<div><a href="../topics/tjear.html">Creating an enterprise application project</a></div> +<div><a href="../topics/tjexpear.html" title="Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.">Exporting an enterprise application into an EAR file</a></div> +<div><a href="../topics/tjcircleb.html" title="You can resolve cyclical dependencies after an EAR is imported.">Correcting cyclical dependencies after an EAR is imported</a></div> +</div> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimprar.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimprar.html new file mode 100644 index 000000000..68bca85ca --- /dev/null +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjimprar.html @@ -0,0 +1,65 @@ +<?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<!-- /******************************************************************************* + * Copyright (c) 2000, 2005 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 + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * IBM Corporation - initial API and implementation + *******************************************************************************/ --> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + +<title>Importing a connector project RAR file</title> +</head> +<body id="tjimprar"><a name="tjimprar"><!-- --></a> +<h1 class="topictitle1">Importing a connector project RAR file</h1> +<div><p>Connector projects are deployed into RAR files. You can import +a connector project by importing a deployed RAR file.</p> +<div class="section"><p>To import a connector project RAR file using the wizard:</p> +</div> +<ol><li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span> > <span class="uicontrol">Import</span></span>. The Import window opens.</span></li> +<li class="stepexpand"><span>Under <span class="uicontrol">Select an import source</span>, click <span class="uicontrol">RAR +file</span>.</span></li> +<li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Connector file</span> field, enter the full +path and name of the connector RAR file that you want to import. Click the <span class="uicontrol">Browse</span> button +to select the RAR file from the file system.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Connector module</span> combination box, +type a new project name or select a connector project from the drop-down list. +If you type a new project name in this field, the connector project will be +created based on the version of the connector RAR file, and it will use the +default location.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> drop-down list, select +the application server that you want to target for your development. This +selection affects the run time settings by modifying the class path entries +for the project.</span></li> +<li class="stepexpand"><span>If you want to add the new connector module to an enterprise application +(EAR) project, select the <span class="uicontrol">Add module to an EAR application</span> check +box.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">EAR application</span> combination box, +type a new project name or select an existing enterprise application project +from the drop-down list. Or, click the <span class="uicontrol">New</span> button to +launch the New Enterprise Application Project wizard.</span> <div class="note"><span class="notetitle">Note:</span> If +you type a new EAR project name, the EAR project will be created in the default +location with the lowest compatible J2EE version based on the version of the +project being created. If you want to specify a different version or a different +location for the enterprise application, you must use the New +Enterprise Application Project wizard.</div> +</li> +<li class="stepexpand"><span>Click <span class="uicontrol">Finish</span> to import the connector RAR +file.</span></li> +</ol> +</div> +<div> +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-importexport.html" title="These topics cover how to import files and projects into the workbench and export files and projects to disk.">Importing and exporting projects and files</a></div> +</div> +</div></body> +</html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjrar.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjrar.html index 65665446f..b4b8f9a80 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjrar.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjrar.html @@ -14,19 +14,21 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Creating a connector project</title> </head> <body id="tjrar"><a name="tjrar"><!-- --></a> - <h1 class="topictitle1">Creating a connector project</h1> -<div><div class="section"> <p>A connector is a J2EE standard extension mechanism for containers +<div><p>A connector is a J2EE standard extension mechanism for containers +to provide connectivity to enterprise information systems (EISs).</p> +<div class="section"> <p> A connector is a J2EE standard extension mechanism for containers to provide connectivity to enterprise information systems (EISs). A connector is specific to an EIS and consists of a resource adapter and application development tools. A resource adapter is a system-level software driver that is used by an EJB container or an application client to connect to an EIS. Connectors comply with the J2EE Connector architecture (JCA).</p> -<div class="restriction"><span class="restrictiontitle">Restriction: </span>J2EE +<div class="restriction"><span class="restrictiontitle">Restriction:</span> J2EE 1.2 specification level does not include connector capability.</div> <p>To create a new connector project:</p> @@ -38,26 +40,30 @@ the <span class="uicontrol">Browse</span> button to select a new location.</span you specify a non-default project location that is already being used by another project, the project creation will fail.</li> <li class="stepexpand"><span>Click <span class="uicontrol">Show Advanced</span>.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Target server</span> list, select the application -server that you want to target for your development. This selection affects -the run time settings by modifying the class path entries for the project.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">JCA version</span> list, select the specification -version to which you want your connector project to adhere.</span> </li> -<li class="stepexpand"><span>If you want to add the new module to an enterprise -application (EAR) project, select the <span class="uicontrol">Add module to an EAR application</span> check -box.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">EAR application</span> list, type a new -project name or select an existing enterprise application project. Or, click -the <span class="uicontrol">New</span> button to launch the New Enterprise Application -Project wizard.</span> <div class="note"><span class="notetitle">Note: </span>If you type a new EAR project name, the EAR -project will be created in the default location with the lowest compatible -J2EE version based on the version of the project being created. If you want -to specify a different version or a different location for the enterprise -application, you must use the New Enterprise Application Project wizard.</div> +<li class="stepexpand"><span>In the <span class="uicontrol">JCA version</span> drop-down list, select +the specification version to which you want your connector project to adhere.</span> </li> +<li class="stepexpand"><span>In the <span class="uicontrol">Target server</span> drop-down list, select +the application server that you want to target for your development. This +selection affects the run time settings by modifying the class path entries +for the project.</span></li> +<li class="stepexpand"><span>Specify whether you want to add the new module to an enterprise +application (EAR) project.</span></li> +<li class="stepexpand"><span>In the <span class="uicontrol">EAR project</span> combination box, type +a new project name or select an existing enterprise application project from +the drop-down list. Or, click the <span class="uicontrol">New</span> button to launch +the New Enterprise Application Project wizard.</span> <div class="note"><span class="notetitle">Note:</span> If you type +a new EAR project name, the EAR project will be created in the default location +with the lowest compatible J2EE version based on the version of the project +being created. If you want to specify a different version or a different location +for the enterprise application, you must use the New Enterprise Application +Project wizard.</div> </li> <li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li> </ol> </div> -<div></div> -</body> +<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>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjtargetserver.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjtargetserver.html index 38cb2d278..382104f2b 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjtargetserver.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjtargetserver.html @@ -3,8 +3,7 @@ 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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<!-- /******************************************************************************* +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><!-- /******************************************************************************* * Copyright (c) 2000, 2005 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 @@ -14,11 +13,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Specifying target servers for J2EE projects</title> </head> <body id="tjtargetserver"><a name="tjtargetserver"><!-- --></a> - <h1 class="topictitle1">Specifying target servers for J2EE projects</h1> <div><p>When you develop J2EE applications, the workbench requires that you specify the server runtime environments for your J2EE projects. The target @@ -55,7 +54,7 @@ Enterprise JavaBeans™ are displayed. All projects inside a single EAR file must be targeted to the same server. If you create a new project and add it to an existing EAR project during creation, the project inherits the target server setting of the EAR project.</p> -<div class="note"><span class="notetitle">Note: </span>Utility Java projects +<div class="note"><span class="notetitle">Note:</span> Utility Java projects that are added to an application are targeted to the same target server as the application. Web library projects that are added to a Web project are targeted to the same target server as the Web project.</div> @@ -67,7 +66,7 @@ the enterprise application or module project, and select <span class="uicontrol" the pop-up menu.</span> The Properties dialog for the project opens.</li> <li class="stepexpand"><span>Select the <span class="uicontrol">Server</span> page on the Properties dialog.</span></li> -<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> list, select +<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> drop-down list, select the server runtime that you want your project to be developed for. This selection impacts the runtime libraries that are added to your project class path. You can click <span class="uicontrol">New</span> to define a new runtime environment that @@ -88,9 +87,12 @@ for available runtime environments when you deploy the project.</span></li> <li class="stepexpand"><span>Click <span class="uicontrol">Apply</span> to save your changes.</span></li> </ol> </div> -<div><div class="relconcepts"><strong>Related concepts</strong><br /> -<div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></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 class="relconcepts"><strong>Related concepts</strong><br /> +<div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div> </div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html index 6dfb58b5a..5aae0a534 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html @@ -4,6 +4,11 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + + + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,11 +19,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Validating code in enterprise applications</title> </head> <body id="tjval"><a name="tjval"><!-- --></a> - <h1 class="topictitle1">Validating code in enterprise applications</h1> <div><div class="section"> <p>The workbench provides manual code validation, code validation during a build, and automatic code validation of project resources. Manual @@ -32,17 +37,23 @@ default, manual code validation and automatic code validation are enabled in the preferences.</p> <p>On the Properties page for each enterprise application module project, you will find a list of validators that you can run against -a selected project. The list of validators is different for each type of project.</p> +a selected project. The list of validators is different for each type of project. </p> +<p>For +more information about validation, see the following topics:</p> </div> </div> <div> <ul class="ullinks"> <li class="ulchildlink"><strong><a href="../topics/rvalerr.html">Common validation errors and solutions</a></strong><br /> -You may encounter these common error messages when you validate your projects.</li> +You may encounter these common error messages when you validate +your projects.</li> <li class="ulchildlink"><strong><a href="../topics/rvalidators.html">J2EE Validators</a></strong><br /> -This table lists the validators that are available for the different project types and gives a brief description of each validator.</li> +This table lists the validators that are available for the different +project types and gives a brief description of each validator.</li> <li class="ulchildlink"><strong><a href="../topics/tjvalauto.html">Enabling automatic code validation</a></strong><br /> -If you want validation to occur automatically during an automatic incremental build that occurs as a result of a resource change, you can enable automatic code validation.</li> +If you want validation to occur automatically during an automatic +incremental build that occurs as a result of a resource change, you can enable +automatic code validation.</li> <li class="ulchildlink"><strong><a href="../topics/tjvalbuild.html">Enabling build validation</a></strong><br /> You can enable validation to occur during a build of a project.</li> <li class="ulchildlink"><strong><a href="../topics/tjvaldisable.html">Disabling a validator</a></strong><br /> @@ -50,14 +61,20 @@ You can disable one or more validators for a project.</li> <li class="ulchildlink"><strong><a href="../topics/tjvalglobalpref.html">Overriding global validation preferences</a></strong><br /> For a given project, you can override the global validation preferences.</li> <li class="ulchildlink"><strong><a href="../topics/tjvalmanual.html">Manually validating code</a></strong><br /> -When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation page of the project Properties dialog.</li> +When you run a manual validation, all resources in the selected +project are validated with the validators that are selected on the Validation +page of the project Properties dialog.</li> <li class="ulchildlink"><strong><a href="../topics/tjvalselect.html">Selecting code validators</a></strong><br /> -You can select specific validators to run for a project during manual and automatic code validation.</li> +You can select specific validators to run for a project during +manual and automatic code validation.</li> </ul> + +<div class="familylinks"> +<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/ph-j2eeapp.html" title="These topics deal with the Java 2 Platform, Enterprise Edition (J2EE).">J2EE Applications</a></div> +</div> <div class="relref"><strong>Related reference</strong><br /> <div><a href="../topics/rvalerr.html" title="You may encounter these common error messages when you validate your projects.">Common validation errors and solutions</a></div> <div><a href="../topics/rvalidators.html" title="This table lists the validators that are available for the different project types and gives a brief description of each validator.">J2EE Validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalauto.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalauto.html index 1256845e4..501460c4b 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalauto.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalauto.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,37 +16,47 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Enabling automatic code validation</title> </head> <body id="tjvalauto"><a name="tjvalauto"><!-- --></a> - <h1 class="topictitle1">Enabling automatic code validation</h1> <div><p>If you want validation to occur automatically during an automatic incremental build that occurs as a result of a resource change, you can enable automatic code validation.</p> -<div class="section"> <p>If automatic incremental builds are disabled, automatic code -validation cannot be enabled.</p> -<p>To enable automatic code validation:</p> +<div class="section"> <p>You can enable automatic code validation for all projects in +your workspace or for only the ones you select.</p> +<p></p> </div> -<ol><li class="stepexpand"><span>On the workbench menu bar, click <span class="menucascade"><span class="uicontrol">Window</span> > <span class="uicontrol">Preferences</span></span>.</span></li> -<li class="stepexpand"><span>In the left frame of the Preferences window, click <span class="menucascade"><span class="uicontrol">General</span> > <span class="uicontrol">Workspace</span></span>.</span></li> -<li class="stepexpand"><span>Select the <span class="uicontrol">Build automatically</span> check box.</span></li> -<li class="stepexpand"><span>Click <span class="uicontrol">OK</span>.</span></li> -<li class="stepexpand"><span>In the Project Explorer view, right-click your project and click <span class="uicontrol">Properties</span>.</span></li> -<li class="stepexpand"><span>On the <span class="uicontrol">Validation</span> page, select the <span class="uicontrol">Override -validation preferences</span> check box to override global preferences -for this project.</span></li> -<li class="stepexpand"><span>Ensure that the validators that you want to run are selected.</span></li> -<li class="stepexpand"><span>Select the <span class="uicontrol">Run validation automatically when you save -changes to <var class="varname"><project_name></var> resources</span> check -box. This check box is only enabled when both of the following conditions -are met:</span> <ul><li>The <span class="uicontrol">Build automatically</span> check box is selected in -the workbench Preferences dialog</li> -<li>The selected project supports automatic validation</li> -</ul> +<ol><li><span>On the workbench menu bar, click <span class="menucascade"><span class="uicontrol">Window</span> > <span class="uicontrol">Preferences</span></span>. The Preferences window opens.</span></li> +<li><span>Click <span class="uicontrol">Validation</span> on the left pane of the +window. This page lists validation options for your entire workspace.</span></li> +<li><span>Select the <span class="uicontrol">Run validation automatically when you save +changes to a resource</span> check box.</span></li> +<li><span>If you want to allow individual projects to have different validation +settings, select the <span class="uicontrol">Allow projects to override these preference +settings</span> check box.</span></li> +<li><span>Choose the validators that you want to use by selecting or clearing +the check boxes next to the list of validators.</span></li> +<li><span>Click <span class="uicontrol">OK</span>. Now, your projects will be validated +automatically when they are changed.</span></li> +<li><span>If you want to set different automatic validation +settings for specific projects, follow these steps:</span><ol type="a"><li><span>In the Project Explorer view, right-click a project and click <span class="uicontrol">Properties</span>. +The Properties window opens.</span></li> +<li><span>Click <span class="uicontrol">Validation</span> on the left pane of +the window. This page lists validation options for the project.</span></li> +<li><span>On the Validation page, select the <span class="uicontrol">Override validation +preferences</span> check box.</span></li> +<li><span>If you want this project to be validated automatically when +you make changes, select the <span class="uicontrol">Run validation automatically when +you make changes to <var class="varname">project_name</var> resources</span> check +box.</span></li> +<li><span>Choose the validators that you want to use by selecting or clearing +the check boxes next to the list of validators.</span></li> +<li><span>Click <span class="uicontrol">OK</span>.</span></li> +</ol> </li> -<li class="stepexpand"><span>Click <span class="uicontrol">OK</span>.</span></li> </ol> <div class="section"> <p>If any errors are detected, an error or warning message is logged in the Problems view. These messages cannot be removed manually. Once the @@ -69,6 +81,5 @@ all messages from that validator are removed.</p> <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation page of the project Properties dialog.">Manually validating code</a></div> <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run for a project during manual and automatic code validation.">Selecting code validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalbuild.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalbuild.html index 5e6fb1428..6fabc84ae 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalbuild.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalbuild.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,11 +16,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Enabling build validation</title> </head> <body id="tjvalbuild"><a name="tjvalbuild"><!-- --></a> - <h1 class="topictitle1">Enabling build validation</h1> <div><p>You can enable validation to occur during a build of a project.</p> <div class="section"> <p>Build validation occurs when you select either <span class="uicontrol">Build @@ -34,13 +36,13 @@ previous build output is deleted and everything is recreated).</p> <p>To enable build validation: </p> </div> -<ol><li><span>In the Project Explorer view, right-click your project and click <span class="uicontrol">Properties</span>.</span></li> +<ol><li><span>In the Project Explorer view, right-click your project and select <span class="uicontrol">Properties</span>.</span></li> <li><span>On the <span class="uicontrol">Validation</span> page, select the <span class="uicontrol">Override validation preferences</span> check box to override global preferences for this project.</span></li> <li><span>Ensure that the validators that you want to run are selected.</span></li> -<li><span>Select the <span class="uicontrol">Run validation when you manually build <var class="varname"><project_name></var></span> check -box. </span></li> +<li><span>Select the <span class="uicontrol">Run validation when you manually +build <project_name></span> check box. </span></li> <li><span>Click <span class="uicontrol">OK</span>.</span></li> </ol> </div> @@ -55,6 +57,5 @@ box. </span></li> <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation page of the project Properties dialog.">Manually validating code</a></div> <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run for a project during manual and automatic code validation.">Selecting code validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html index a4e1fd41d..953911693 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,17 +16,17 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Disabling a validator</title> </head> <body id="tjvaldisable"><a name="tjvaldisable"><!-- --></a> - <h1 class="topictitle1">Disabling a validator</h1> <div><p>You can disable one or more validators for a project.</p> <div class="section"> <p>Errors and warning messages are displayed in the Problems view when validation is run. To disable one or more validators for a project:</p> </div> -<ol><li><span>In the Project Explorer view, right-click your project and click <span class="uicontrol">Properties</span>.</span></li> +<ol><li><span>In the Project Explorer view, right-click your project and select <span class="uicontrol">Properties</span>.</span></li> <li><span>On the <span class="uicontrol">Validation</span> page, select the <span class="uicontrol">Override validation preferences</span> check box to override global preferences for this project.</span></li> @@ -45,6 +47,5 @@ run automatically, manually, or during a build.</div> <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation page of the project Properties dialog.">Manually validating code</a></div> <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run for a project during manual and automatic code validation.">Selecting code validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html index 1855125b3..234e6a2c8 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,11 +16,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Overriding global validation preferences</title> </head> <body id="tjvalglobalpref"><a name="tjvalglobalpref"><!-- --></a> - <h1 class="topictitle1">Overriding global validation preferences</h1> <div><p>For a given project, you can override the global validation preferences.</p> <div class="section"> <p>The default validation preferences are specified globally on @@ -42,6 +44,5 @@ selected.</span></li> <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation page of the project Properties dialog.">Manually validating code</a></div> <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run for a project during manual and automatic code validation.">Selecting code validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html index 371322362..d8147bf22 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,11 +16,11 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Manually validating code</title> </head> <body id="tjvalmanual"><a name="tjvalmanual"><!-- --></a> - <h1 class="topictitle1">Manually validating code</h1> <div><p>When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation @@ -26,7 +28,7 @@ page of the project Properties dialog.</p> <div class="section"><p>To manually invoke an immediate code validation:</p> </div> <ol><li class="stepexpand"><span>Select the project that you want to validate.</span></li> -<li class="stepexpand"><span>Right-click the project and click <span class="uicontrol">Run Validation</span>.</span> If no validators were selected, a message box provides information about +<li class="stepexpand"><span>Right-click the project and select <span class="uicontrol">Run Validation</span>.</span> If no validators were selected, a message box provides information about how to select a validator.</li> </ol> <div class="section">Validation of the project is performed using the selected validators @@ -43,6 +45,5 @@ for the project.</div> <div><a href="../topics/tjvalglobalpref.html" title="For a given project, you can override the global validation preferences.">Overriding global validation preferences</a></div> <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run for a project during manual and automatic code validation.">Selecting code validators</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html index f25996781..c6a395aaa 100644 --- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html +++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html @@ -4,6 +4,8 @@ <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <!-- /******************************************************************************* * Copyright (c) 2000, 2005 IBM Corporation and others. * All rights reserved. This program and the accompanying materials @@ -14,21 +16,21 @@ * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ --> -<link rel="stylesheet" type="text/css" href="../org.eclipse.wst.doc.user/common.css" /> +<link rel="stylesheet" type="text/css" href="../../org.eclipse.wtp.doc.user/common.css" /> + <title>Selecting code validators</title> </head> <body id="tjvalselect"><a name="tjvalselect"><!-- --></a> - <h1 class="topictitle1">Selecting code validators</h1> <div><p>You can select specific validators to run for a project during manual and automatic code validation.</p> <div class="section"><p>To choose the validators that you want to use for a project:</p> </div> -<ol><li class="stepexpand"><span>In the Project Explorer view, right-click your project and click <span class="uicontrol">Properties</span>.</span></li> +<ol><li class="stepexpand"><span>In the Project Explorer view, right-click your project and select <span class="uicontrol">Properties</span>.</span></li> <li class="stepexpand"><span>On the <span class="uicontrol">Validation</span> page, select the <span class="uicontrol">Override validation preferences</span> check box to override global preferences for this project.</span></li> -<li class="stepexpand"><span>Select the validators that you want to run. </span> <div class="note"><span class="notetitle">Note: </span>If +<li class="stepexpand"><span>Select the validators that you want to run. </span> <div class="note"><span class="notetitle">Note:</span> If you deselect any validator that is currently selected, any messages associated with the deselected validator will be removed from the task list.</div> </li> @@ -46,6 +48,5 @@ with the deselected validator will be removed from the task list.</div> <div><a href="../topics/tjvalglobalpref.html" title="For a given project, you can override the global validation preferences.">Overriding global validation preferences</a></div> <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated with the validators that are selected on the Validation page of the project Properties dialog.">Manually validating code</a></div> </div> -</div> -</body> +</div></body> </html>
\ No newline at end of file |
