Author: vmassol Date: Sun Jan 16 03:00:52 2005 New Revision: 125352 URL: http://svn.apache.org/viewcvs?view=rev&rev=125352 Log: Initial implementation of a maven plugin used to handle webstart related stuff (starting a webstart application, configuring the webstart cache to any user-defined directory, etc). The future goal is to have the abbot plugin depends on this plugin (The abbot plugin has one goal that allows a webstart swing application to be tested) for its webstart features. Added: maven/maven-1/plugins-sandbox/trunk/webstart/ maven/maven-1/plugins-sandbox/trunk/webstart/plugin.jelly maven/maven-1/plugins-sandbox/trunk/webstart/plugin.properties maven/maven-1/plugins-sandbox/trunk/webstart/project.xml maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/changes.xml maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/goals.xml maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/index.xml maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/navigation.xml maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/properties.xml maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/using.xml
Added: maven/maven-1/plugins-sandbox/trunk/webstart/plugin.jelly Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/plugin.jelly?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/plugin.jelly Sun Jan 16 03:00:52 2005 @@ -0,0 +1,227 @@ +<?xml version="1.0"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<!-- + ============================================================================= + Create a Webstart Cache at the specified location + ============================================================================= +--> +<project + xmlns:j="jelly:core" + xmlns:abbot="abbot" + xmlns:u="jelly:util" + xmlns:x="jelly:xml" + xmlns:define="jelly:define" + xmlns:maven="jelly:maven"> + + <!-- + ======================================================================= + Setup a Webstart Cache at a user-defined location. This location is + where Webstart will download all the jars + ======================================================================= + --> + <goal name="webstart:create-cache" + prereqs="webstart:init" + description="Set up a Webstart Cache in a user-defined location"> + + <property environment="env"/> + + <j:set var="envJavaHome" value="${env.JAVA_HOME}"/> + <j:set var="javaHome" value="${envJavaHome.replaceAll('\\', '\\\\')}"/> + + <!-- Create a deployment.properties file in the Webstart Cache directory --> + <j:file name="${maven.webstart.cache.location}/deployment.properties" prettyPrint="false" omitXmlDeclaration="true"> +deployment.javaws.logToFile=true +deployment.javaws.logFileName=${maven.webstart.cache.location}/webstart.log +deployment.javaws.proxy.httpproxyoverride= +deployment.javaws.version=javaws-1.4.2_01 + +deployment.javaws.player.manager= +deployment.javaws.player.mode= +deployment.javaws.whenInstall= +deployment.javaws.splash.cache= + +deployment.javaws.jre.0.location=http\://java.sun.com/products/autodl/j2se +deployment.javaws.jre.0.enabled=true +deployment.javaws.jre.0.registered=true +deployment.javaws.jre.0.product=1.4.2_01 +deployment.javaws.jre.0.path=${javaHome}\\bin\\javaw.exe +deployment.javaws.jre.0.platform=1.4 + </j:file> + + </goal> + + <!-- + ======================================================================= + Initialize the Webstart environment. Check if all the required + properties are defined + ======================================================================= + --> + <goal name="webstart:init"> + + <property environment="env"/> + + <j:if test="${context.getVariable('env.JAVA_HOME') == null}"> + <fail>Mandatory environment variable JAVA_HOME must be set</fail> + </j:if> + + <maven:param-check value="${maven.webstart.cache.location}" fail="true"> + The Webstart Cache location must be specified using the maven.webstart.cache.location property + </maven:param-check> + + <!-- Setup the Webstart SystemHome property --> + <maven:set plugin="maven-webstart-plugin" property="maven.webstart.javaws.systemhome" value="${env.JAVA_HOME}/jre/javaws"/> + + <!-- Create the Webstart Cache directory, if it doesn't already exist --> + <mkdir dir="${maven.webstart.cache.location}"/> + + </goal> + + <!-- + ======================================================================== + Download the application from the remote location and start it locally + using the Jetty server. This is done to reduce the time Webstart spends + in detecting a version update on the remote location. + ======================================================================== + --> + <goal name="webstart:start-local-app" + prereqs="webstart:init" + description="Download and start app locally using Jetty"> + + <j:if test="${context.getVariable('maven.webstart.local') == false}"> + <echo>Local Webstart feature is disabled. To enable it, set the maven.webstart.local property to true</echo> + </j:if> + + <j:if test="${context.getVariable('maven.webstart.local') == true}"> + + <attainGoal name="webstart:check-env"/> + + <!-- Create the folder where the application should be downloaded --> + <mkdir dir="${maven.webstart.webapp.location}"/> + + <!-- Get the jnlp file from the remote location. This file contains a list + of all the jars needed to run the Client application --> + <get src="${maven.webstart.remotejnlp}" + dest="${maven.webstart.webapp.location}/${maven.webstart.jnlp.name}"/> + + <!-- Parse the jnlp file. Get all the jars from the remote location and + store them in the folder created above --> + <u:file var="inputFile" name="${maven.webstart.webapp.location}/${maven.webstart.jnlp.name}"/> + <x:parse var="parsedfile" xml="${inputFile}"/> + <x:set var="codeBaseName" select="string($parsedfile/jnlp/@codebase)"/> + <x:forEach var="jar" select="$parsedfile/jnlp/resources/jar"> + <x:set var="jarName" select="string($jar/@href)"/> + <get src="${codeBaseName}/${jarName}" usetimestamp="true" + dest="${maven.webstart.webapp.location}/${jarName}"/> + </x:forEach> + + <!-- Create a Jetty Configuration file to start the application locally using Jetty --> + <j:file name="${maven.jetty.config.xml}" prettyPrint="true" xmlns="jetty"> + + <x:doctype name="Configure" publicId="-//Mort Bay Consulting//DTD Configure 1.2//EN" systemId="http://jetty.mortbay.org/configure_1_2.dtd"/> + + <Configure class="org.mortbay.jetty.Server"> + <Call name="addListener"> + <Arg> + <New class="org.mortbay.http.SocketListener"> + <Set name="Port">${maven.webstart.localapp.port}</Set> + <Set name="Host">${maven.webstart.localapp.host}</Set> + </New> + </Arg> + </Call> + + <Call name="addWebApplication"> + <Arg>${maven.webstart.localapp.resourcebase}</Arg> + <Arg>${maven.webstart.webapp.location}</Arg> + </Call> + </Configure> + </j:file> + + <!-- Start Jetty in a separate thread so that the remaining script can be + executed --> + <j:thread> + <attainGoal name="jetty:run"/> + </j:thread> + </j:if> + + </goal> + +<!-- + ======================================================================= + Check if all the required properties for Local Webstart are defined + ======================================================================= + --> + <goal name="webstart:check-env"> + + <maven:param-check value="${maven.webstart.remotejnlp}" fail="true"> + The URL of the Remote Application must be specified using the maven.webstart.remotejnlp property + </maven:param-check> + + <maven:param-check value="${maven.webstart.localapp.host}" fail="true"> + The Host name of the locally installed application must be specified using the maven.webstart.localapp.host property + </maven:param-check> + + <maven:param-check value="${maven.webstart.localapp.port}" fail="true"> + The Port of the locally installed application must be specified using the maven.webstart.localapp.port property + </maven:param-check> + + <maven:param-check value="${maven.webstart.localapp.resourcebase}" fail="true"> + The Resource Base of the locally installed application must be specified using the maven.webstart.localapp.resourcebase property + </maven:param-check> + + </goal> + + <!-- + ======================================================================= + Launch Webstart to open the application specified in the JNLP file + provided. + ======================================================================= + --> + <goal name="webstart:launch" + prereqs="webstart:init" + description="Launch the Webstart Application"> + + <j:if test="${maven.webstart.local} == 'true'"> + <attainGoal name="webstart:check-env"/> + </j:if> + + <maven:param-check value="${maven.webstart.jnlp.location}" fail="true"> + The location of the JNLP file on which to launch Webstart must be specified using the maven.webstart.jnlp.location property + </maven:param-check> + + <!-- Java webstart is launched on local modified jnlp --> + <java classname="com.sun.javaws.Main" fork="true" failonerror="true"> + <classpath> + <pathelement location="${env.JAVA_HOME}/jre/javaws/javaws-l10n.jar"/> + <pathelement location="${env.JAVA_HOME}/jre/javaws/javaws.jar"/> + </classpath> + <jvmarg value="-Djnlpx.home=${env.JAVA_HOME}/jre/javaws"/> + <jvmarg value="-Djnlpx.heapsize=NULL,NULL"/> + <jvmarg value="-Djnlpx.jvm=${env.JAVA_HOME}/bin/javaw.exe"/> + <jvmarg value="-Djnlpx.deployment.system.home=${maven.webstart.javaws.systemhome}"/> + <jvmarg value="-Djnlpx.deployment.user.home=${maven.webstart.cache.location}"/> + <jvmarg value="-Djava.security.policy=${env.JAVA_HOME}/jre/javaws/javaws.policy"/> + <jvmarg value="-DtrustProxy=true"/> + <arg value="${maven.webstart.jnlp.location}"/> + </java> + + </goal> + +</project> Added: maven/maven-1/plugins-sandbox/trunk/webstart/plugin.properties Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/plugin.properties?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/plugin.properties Sun Jan 16 03:00:52 2005 @@ -0,0 +1,47 @@ +# ------------------------------------------------------------------- +# Copyright 2005 The Apache Software Foundation. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# ------------------------------------------------------------------- + +# Specify the path where you want to set up the Java Webstart Cache +maven.webstart.cache.location=${maven.build.dir}/webstart/cache + +# Location of the JNLP file on which to launch Webstart +# This is a mandatory property without which Webstart will fail to launch +# Ex : maven.webstart.jnlp.location = ${maven.webstart.webapp.location}/${maven.webstart.jnlp.name} + +# Properties required for the "start-local-app" & "launch" goals +# -------------------------------------------------------------- + +# Specify whether the Local Webstart feature should be used or not +maven.webstart.local = false + +# This property points to the JNLP file of the application you're testing +# Ex : maven.webstart.remotejnlp = http://localhost:8080/app.jnlp + +# Location where the application will be installed locally +maven.webstart.webapp.location = ${maven.build.dir}/webstart/localapp + +# The JNLP name which will be used to access the application +maven.webstart.jnlp.name = localapp.jnlp + +# Location & Name of the Configuration file for Jetty +maven.jetty.config.xml = ${maven.build.dir}/jetty.xml + +# URL and Resource Base of the application to launch +# These properties are optional and only useful if you want to launch Webstart +# on a locally installed application. +# Ex : maven.webstart.localapp.host = localhost +# Ex : maven.webstart.localapp.port = 8080 +# Ex : maven.webstart.localapp.resourcebase = / Added: maven/maven-1/plugins-sandbox/trunk/webstart/project.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/project.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/project.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<project> + <extend>../plugin-parent/project.xml</extend> + <id>maven-webstart-plugin</id> + <name>Maven Webstart Plugin</name> + <currentVersion>1.0-SNAPSHOT</currentVersion> + <description> + Provides goals related to using Java Webstart + </description> + <shortDescription>Maven Webstart Plugin</shortDescription> + <url>http://maven.apache.org/reference/plugins/webstart/</url> + <issueTrackingUrl>http://jira.codehaus.org/browse/MPWEBSTART</issueTrackingUrl> + <siteDirectory>/www/maven.apache.org/reference/plugins/webstart/</siteDirectory> + <repository> + <connection>scm:svn:http://svn.apache.org/repos/asf/maven/maven-1/plugins-sandbox/trunk/webstart/</connection> + <developerConnection>scm:svn:https://svn.apache.org/repos/asf/maven/maven-1/plugins-sandbox/trunk/webstart/</developerConnection> + <url>http://svn.apache.org/viewcvs.cgi/maven/maven-1/plugins-sandbox/trunk/webstart/</url> + </repository> + <developers> + <developer> + <name>Vincent Massol</name> + <id>vmassol</id> + <email>[EMAIL PROTECTED]</email> + <organization>maven.org</organization> + <roles> + <role>Java Developer</role> + </roles> + </developer> + <developer> + <name>Girish Deuskar</name> + <id>gdeuskar</id> + <email>[EMAIL PROTECTED]</email> + <organization>KPIT Cummins Infosystems Ltd</organization> + <roles> + <role>Java Developer</role> + </roles> + </developer> + </developers> + <dependencies/> +</project> Added: maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/changes.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/changes.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/changes.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,35 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<document> + <properties> + <title>Changes</title> + <author email="[EMAIL PROTECTED]">Girish Deuskar</author> + </properties> + <body> + <release version="1.0-SNAPSHOT" date="in SVN"> + <action dev="vmassol" type="add"> + Initial plugin creation by Girish Deuskar. See the feature list on + the Webstart plugin web site for a full list of what the plugin + does. + </action> + </release> + </body> +</document> Added: maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/goals.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/goals.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/goals.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<document> + <properties> + <title>Maven Webstart plugin goals</title> + <author email="[EMAIL PROTECTED]">Girish Deuskar</author> + </properties> + <body> + <goals> + <goal> + <name>webstart:create-cache</name> + <description> + Setup a Webstart Cache at a user-defined location. This location is + where Webstart will download all the jars. + </description> + </goal> + <goal> + <name>webstart:start-local-app</name> + <description> + Download the application from the remote location and start it locally + using the Jetty server. This is done to reduce the time Webstart + spends in detecting a version update on the remote location. + </description> + </goal> + <goal> + <name>webstart:launch</name> + <description> + Launch Webstart to open the application specified in the JNLP file + provided. + </description> + </goal> + </goals> + </body> +</document> \ No newline at end of file Added: maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/index.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/index.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/index.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,63 @@ +<?xml version="1.0"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<document> + + <properties> + <title>Maven Webstart plugin</title> + <author email="[EMAIL PROTECTED]">Girish Deuskar</author> + </properties> + + <body> + <section name="What is the Webstart plugin?"> + <p> + Provides the following features: + </p> + <ul> + <li> + Ability to setup the Webstart Cache in any location on the + hard-disk, not necessarily the Webstart default which is in + the User Home. This Webstart Cache is where Webstart will + download all the jars to launch a particular application + </li> + <li> + Ability to start the application locally. This is especially useful + if the Application Server on which the application is deployed is at + a Remote location and the connection speed is not too fast. Webstart + by default connects to the Application Server each time to check the + version of the jars. The plugin provides a feature wherein the + application is downloaded and then run on localhost thereby reducing + the time Webstart spends in detecting version updates. + </li> + <li> + Ability to launch Webstart to open the application specified in the + JNLP file provided. + </li> + </ul> + </section> + <section name="Using the plugin"> + <p> + See the <a href="using.html">usage tutorial</a>. + </p> + </section> + + </body> + +</document> Added: maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/navigation.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/navigation.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/navigation.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,36 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<project name="Maven Webstart plugin"> + + <title>Maven Webstart plugin</title> + + <body> + <links> + <item name="Maven" href="http://maven.apache.org/"/> + <item name="Webstart" href="http://java.sun.com/products/javawebstart/"/> + </links> + <menu name="Overview"> + <item name="Using" href="/using.html"/> + <item name="Goals" href="/goals.html"/> + <item name="Properties" href="/properties.html"/> + </menu> + </body> +</project> Added: maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/properties.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/properties.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/properties.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<document> + <properties> + <title>Maven Webstart plugin properties</title> + <author email="[EMAIL PROTECTED]">Girish Deuskar</author> + </properties> + <body> + <section name="Webstart plugin properties"> +<source><![CDATA[ +# Specify the path where you want to set up the Java Webstart Cache +maven.webstart.cache.location=${maven.build.dir}/webstart/cache + +# Location of the JNLP file on which to launch Webstart +# This is a mandatory property without which Webstart will fail to launch +# Ex : maven.webstart.jnlp.location = ${maven.webstart.webapp.location}/${maven.webstart.jnlp.name} + +# Properties required for the "start-local-app" & "launch" goals +# -------------------------------------------------------------- + +# Specify whether the Local Webstart feature should be used or not +maven.webstart.local = false + +# This property points to the JNLP file of the application you're testing +# Ex : maven.webstart.remotejnlp = http://localhost:8080/app.jnlp + +# Location where the application will be installed locally +maven.webstart.webapp.location = ${maven.build.dir}/webstart/localapp + +# The JNLP name which will be used to access the application +maven.webstart.jnlp.name = localapp.jnlp + +# Location & Name of the Configuration file for Jetty +maven.jetty.config.xml = ${maven.build.dir}/jetty.xml + +# URL and Resource Base of the application to launch +# These properties are optional and only useful if you want to launch Webstart +# on a locally installed application. +# Ex : maven.webstart.localapp.host = localhost +# Ex : maven.webstart.localapp.port = 8080 +# Ex : maven.webstart.localapp.resourcebase = / +]]></source> + </section> + </body> +</document> \ No newline at end of file Added: maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/using.xml Url: http://svn.apache.org/viewcvs/maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/using.xml?view=auto&rev=125352 ============================================================================== --- (empty file) +++ maven/maven-1/plugins-sandbox/trunk/webstart/xdocs/using.xml Sun Jan 16 03:00:52 2005 @@ -0,0 +1,70 @@ +<?xml version="1.0"?> + +<!-- +/* + * Copyright 2005 The Apache Software Foundation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + --> + +<document> + + <properties> + <title>Using the Webstart plugin</title> + <author email="[EMAIL PROTECTED]">Girish Deuskar</author> + </properties> + + <body> + + <section name="Using the Webstart plugin"> + <p> + Using the Webstart plugin is as simple as using the webstart:launch + goal. + However, to take advantage of the other features, the user can, if he + wishes, follow these steps + </p> + <ul> + <li> + Use the <code>webstart:create-cache</code> goal to setup a Webstart + Cache at a user-defined location. You would call this goal from + inside your application project in case you want to change the + location of your Webstart Cache. This location is where Webstart + downloads all the jars for your application + </li> + <li> + Use the <code>webstart:start-local-app</code> goal if you want to + start the application locally. For this, you need to set the + property "maven.webstart.local = true". You would call this goal if + you access a Remote Application and the connection speed is not too + great. Using this goal reduces the time Webstart spends in detecting + a version update on the remote location. + </li> + <li> + Use the <code>webstart:launch</code> goal to start Webstart on the + JNLP file you provide. + </li> + </ul> + <p> + Note however, that the plugin can be used to call any of these goals + individually. It is not necessary to call these goals in the specified + order. + Also, some mandatory environment-dependent properties need to be + defined. See the <a href="properties.html">Properties</a> page for + the details + </p> + </section> + + </body> + +</document> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
