You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by vm...@apache.org on 2005/01/16 12:00:54 UTC

svn commit: r125352 - in maven/maven-1/plugins-sandbox/trunk/webstart: . xdocs

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>vmassol@apache.org</email>
+      <organization>maven.org</organization>
+      <roles>
+        <role>Java Developer</role>
+      </roles>
+    </developer>
+    <developer>
+      <name>Girish Deuskar</name>
+      <id>gdeuskar</id>
+      <email>girish.deuskar@gmail.com</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="girish.deuskar@gmail.com">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="girish.deuskar@gmail.com">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="girish.deuskar@gmail.com">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="girish.deuskar@gmail.com">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="girish.deuskar@gmail.com">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: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org