You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by jo...@apache.org on 2006/11/06 21:50:35 UTC
svn commit: r471875 - in /webservices/axis2/branches/java/1_1/modules/tool:
axis2-aar-maven-plugin/src/site/apt/ axis2-java2wsdl-maven-plugin/
axis2-java2wsdl-maven-plugin/src/changes/
axis2-java2wsdl-maven-plugin/src/main/java/org/apache/axis2/maven2/...
Author: jochen
Date: Mon Nov 6 12:50:34 2006
New Revision: 471875
URL: http://svn.apache.org/viewvc?view=rev&rev=471875
Log:
Added docs for the java2wsdl plugin.
Added:
webservices/axis2/branches/java/1_1/modules/tool/axis2-aar-maven-plugin/src/site/apt/introduction.apt
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/changes/
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/changes/changes.xml
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/configuration.apt
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/goals.apt
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/introduction.apt
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/site.xml
webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/changes/
webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/changes/changes.xml
Modified:
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/pom.xml
webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/main/java/org/apache/axis2/maven2/java2wsdl/Java2WSDLMojo.java
webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/pom.xml
webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/site/apt/introduction.apt
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-aar-maven-plugin/src/site/apt/introduction.apt
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-aar-maven-plugin/src/site/apt/introduction.apt?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-aar-maven-plugin/src/site/apt/introduction.apt (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-aar-maven-plugin/src/site/apt/introduction.apt Mon Nov 6 12:50:34 2006
@@ -0,0 +1,15 @@
+ ------
+ Maven 2 Aar Plugin
+ ------
+ Jochen Wiedmann
+ <jo...@gmail.com>
+ ------
+
+Introduction
+
+ This plugin generates an Axis 2 service file (AAR file).
+
+ The full description of goals is available {{{howto.html}here}}.
+
+
+
Modified: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/pom.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/pom.xml?view=diff&rev=471875&r1=471874&r2=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/pom.xml (original)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/pom.xml Mon Nov 6 12:50:34 2006
@@ -58,4 +58,24 @@
<artifactId>maven-plugin-testing-harness</artifactId>
</dependency>
</dependencies>
+
+ <reporting>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-javadoc-plugin</artifactId>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-changes-plugin</artifactId>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>changes-report</report>
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+ </plugins>
+ </reporting>
</project>
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/changes/changes.xml?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/changes/changes.xml (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/changes/changes.xml Mon Nov 6 12:50:34 2006
@@ -0,0 +1,17 @@
+<document>
+ <properties>
+ <title>Changes in the Axis2 Java2WSDL plugin for Maven 2</title>
+ </properties>
+ <body>
+ <release version="1.1-SNAPSHOT" date="Not yet released">
+ <action dev="jochen" type="add">
+ Added user documentation.
+ </action>
+ </release>
+ <release version="1.0-SNAPSHOT" date="Not yet released">
+ <action dev="jochen" type="add">
+ Initial version. Never actually published.
+ </action>
+ </release>
+ </body>
+</document>
Modified: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/main/java/org/apache/axis2/maven2/java2wsdl/Java2WSDLMojo.java
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/main/java/org/apache/axis2/maven2/java2wsdl/Java2WSDLMojo.java?view=diff&rev=471875&r1=471874&r2=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/main/java/org/apache/axis2/maven2/java2wsdl/Java2WSDLMojo.java (original)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/main/java/org/apache/axis2/maven2/java2wsdl/Java2WSDLMojo.java Mon Nov 6 12:50:34 2006
@@ -48,45 +48,45 @@
/**
* Fully qualified name of the class, which is being inspected.
- * @parameter
+ * @parameter expression="${axis2.java2wsdl.className}"
* @required
*/
private String className;
/**
* Target namespace of the generated WSDL.
- * @parameter
+ * @parameter expression="${axis2.java2wsdl.targetNamespace}"
*/
private String targetNamespace;
/**
* The namespace prefix, which is being used for the WSDL's
* target namespace.
- * @parameter
+ * @parameter expression="${axis2.java2wsdl.targetNamespacePrefix}"
*/
private String targetNamespacePrefix;
/**
* The generated schemas target namespace.
- * @parameter
+ * @parameter expression="${axis2.java2wsdl.schemaTargetNamespace}"
*/
private String schemaTargetNamespace;
/**
* The generated schemas target namespace prefix.
- * @parameter
+ * @parameter expression="${axis2.java2wsdl.schemaTargetNamespacePrefix}"
*/
private String schemaTargetNamespacePrefix;
/**
* Name of the generated service.
- * @parameter
+ * @parameter expression="${axis2.java2wsdl.serviceName}"
*/
private String serviceName;
/**
* Name of the service file, which is being generated.
- * @parameter default-value="target/generated-sources/java2wsdl/service.xml"
+ * @parameter expression="${axis2.java2wsdl.outputFileName}" default-value="${project.build.outputDirectory}/generated-resources/java2wsdl/service.xml"
*/
private String outputFileName;
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/configuration.apt
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/configuration.apt?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/configuration.apt (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/configuration.apt Mon Nov 6 12:50:34 2006
@@ -0,0 +1,30 @@
+Configuration
+
+ The Java2WSDL goal takes the following parameters as input. All parameters can be set from the command line by using
+ properties. For example, the parameter "className" may be set using the property
+ "axis2.java2wsdl.className". If the parameter isn't set via property or in the POM, then a default
+ value applies.
+
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| Parameter name | Command line property | Description |
+| | Default value | |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| className | ${axis2.java2wsdl.className} | Fully qualified name of the class, which is |
+| | | being read and transformed into a WSDL. |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| outputFileName | ${axis2.java2wsdl.outputFileName} | Path of the generated service file. |
+*-----------------------------*------------------------------------------------*------------------------------------------------*
+| schemaTargetNamespace | ${axis2.java2wsdl.schemaTargetNamespace} | Target namespace of the generated schema. |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| schemaTargetNamespacePrefix | ${axis2.java2wsdl.schemaTargetNamespacePrefix} | Prefix, which is being associated with the |
+| | | schemas target namespace. |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| serviceName | ${axis2.java2wsdl.serviceName} | Name of the generated web service. |
+| | Unqualified name of the input class. | |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| targetNamespace | ${axis2.java2wsdl.targetNamespace} | Target namespace of the generated WSDL. |
+| | Default namespace | |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
+| targetNamespacePrefix | ${axis2.java2wsdl.targetNamespacePrefix} | Prefix, which is being associated with the |
+| | | target namespace. |
+*-----------------------------+------------------------------------------------+------------------------------------------------+
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/goals.apt
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/goals.apt?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/goals.apt (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/goals.apt Mon Nov 6 12:50:34 2006
@@ -0,0 +1,54 @@
+ ------
+ Maven 2 Java2WSDL Plugin: configuration examples
+ ------
+ Jochen Wiedmann
+ <jo...@gmail.com>
+ ------
+
+Goals
+
+ The Java2WSDL plugin offers a single goal:
+
+ * java2wsdl (default): Reads a java class and generates a WSDL for invoking the classes methods as a web service.
+
+ To run the plugin, add the following section to your POM:
+
+------------------------
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.axis2.maven2</groupId>
+ <artifactId>axis2-java2wsdl-maven-plugin</artifactId>
+ <executions>
+ <execution>
+ <goals>
+ <goal>java2wsdl</goal>
+ </goals>
+ </execution>
+ <configuration>
+ <className>com.foo.myservice.MyHandler</className>
+ </configuration>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+------------------------
+
+ The plugin will be invoked automatically in the generate-resources
+ phase. You can also invoke it directly from the command line by
+ running the command
+
++--------
+ mvn java2wsdl:java2wsdl
++---------
+
+
+The Java2WSDL Goal
+
+ By default, the plugin reads the given Java class and creates a
+ file <<<target/generated-resources/java2wsdl/service.xml>>>. The
+ Java class is given by the configuration element <<<className>>>
+ above.
+
+ See the detailed documentation on {{{configuration.html}properties}} for
+ how to configure the goal.
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/introduction.apt
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/introduction.apt?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/introduction.apt (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/apt/introduction.apt Mon Nov 6 12:50:34 2006
@@ -0,0 +1,14 @@
+ ------
+ Maven 2 Java2WSDL Plugin
+ ------
+ Jochen Wiedmann
+ <jo...@gmail.com>
+ ------
+
+Introduction
+
+ This plugin takes as input a Java class and generates a WSDL,
+ which describes a web service for invoking the classes
+ methods.
+
+ The full description of goals is available {{{goals.html}here}}.
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/site.xml?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/site.xml (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-java2wsdl-maven-plugin/src/site/site.xml Mon Nov 6 12:50:34 2006
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+/*
+ * Copyright 2006 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 Axis 2 Java2WSDL Plugin">
+ <bannerLeft>
+ <name>Maven Axis 2 Java2WSDL Plugin</name>
+ <src>http://maven.apache.org/images/apache-maven-project.png</src>
+ <href>http://maven.apache.org/</href>
+ </bannerLeft>
+ <bannerRight>
+ <src>http://maven.apache.org/images/maven-small.gif</src>
+ </bannerRight>
+ <body>
+ <links>
+ <item name="Apache" href="http://www.apache.org/"/>
+ <item name="Webservices" href="http://ws.apache.org/"/>
+ <item name="Axis 2" href="http://ws.apache.org/axis2/"/>
+ <item name="Maven 2" href="http://maven.apache.org/maven2/"/>
+ </links>
+
+ <menu name="Overview">
+ <item name="Introduction" href="introduction.html"/>
+ <item name="How to Use" href="howto.html"/>
+ <item name="Configuration" href="configuration.html"/>
+ </menu>
+ ${reports}
+ </body>
+</project>
Modified: webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/pom.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/pom.xml?view=diff&rev=471875&r1=471874&r2=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/pom.xml (original)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/pom.xml Mon Nov 6 12:50:34 2006
@@ -81,4 +81,24 @@
<artifactId>plexus-utils</artifactId>
</dependency>
</dependencies>
+
+ <reporting>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-javadoc-plugin</artifactId>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-changes-plugin</artifactId>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>changes-report</report>
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+ </plugins>
+ </reporting>
</project>
Added: webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/changes/changes.xml?view=auto&rev=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/changes/changes.xml (added)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/changes/changes.xml Mon Nov 6 12:50:34 2006
@@ -0,0 +1,17 @@
+<document>
+ <properties>
+ <title>Changes in the Axis2 WSDL2Code plugin for Maven 2</title>
+ </properties>
+ <body>
+ <release version="1.1-SNAPSHOT" date="Not yet released">
+ <action dev="jochen" type="add">
+ Added user documentation.
+ </action>
+ </release>
+ <release version="1.0-SNAPSHOT" date="Not yet released">
+ <action dev="jochen" type="add">
+ Initial version. Never actually published.
+ </action>
+ </release>
+ </body>
+</document>
Modified: webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/site/apt/introduction.apt
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/site/apt/introduction.apt?view=diff&rev=471875&r1=471874&r2=471875
==============================================================================
--- webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/site/apt/introduction.apt (original)
+++ webservices/axis2/branches/java/1_1/modules/tool/axis2-wsdl2code-maven-plugin/src/site/apt/introduction.apt Mon Nov 6 12:50:34 2006
@@ -7,7 +7,7 @@
Introduction
- This plugin generates takes as input a WSDL and generates client
+ This plugin takes as input a WSDL and generates client
and server stubs for calling or implementing a web service
matching the WSDL.
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org