You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-commits@axis.apache.org by ve...@apache.org on 2012/01/11 20:52:06 UTC

svn commit: r1230211 - in /axis/axis1/java/trunk: docs/index.html docs/reading.html src/site/xdoc/overview.xml src/site/xdoc/reading.xml

Author: veithen
Date: Wed Jan 11 19:52:05 2012
New Revision: 1230211

URL: http://svn.apache.org/viewvc?rev=1230211&view=rev
Log:
Some more site migration work.

Added:
    axis/axis1/java/trunk/src/site/xdoc/overview.xml
      - copied, changed from r1230195, webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/index.xml
    axis/axis1/java/trunk/src/site/xdoc/reading.xml
      - copied, changed from r1230199, webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/reading.xml
Removed:
    axis/axis1/java/trunk/docs/index.html
    axis/axis1/java/trunk/docs/reading.html

Copied: axis/axis1/java/trunk/src/site/xdoc/overview.xml (from r1230195, webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/index.xml)
URL: http://svn.apache.org/viewvc/axis/axis1/java/trunk/src/site/xdoc/overview.xml?p2=axis/axis1/java/trunk/src/site/xdoc/overview.xml&p1=webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/index.xml&r1=1230195&r2=1230211&rev=1230211&view=diff
==============================================================================
--- webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/index.xml (original)
+++ axis/axis1/java/trunk/src/site/xdoc/overview.xml Wed Jan 11 19:52:05 2012
@@ -1,20 +1,35 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "./dtd/document-v12.dtd">
-<document>
-  <header>
-    <title>WebServices - Axis</title>
-  </header>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one
+  ~ or more contributor license agreements. See the NOTICE file
+  ~ distributed with this work for additional information
+  ~ regarding copyright ownership. The ASF licenses this file
+  ~ to you 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 xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+  <properties>
+    <title>Documentation overview</title>
+  </properties>
   <body>
 
-<a name="Documentation"/>
-<section>
-<title>Documentation</title>
-
-<p>This is the documentation for <a href="http://ws.apache.org/axis/">Apache Axis 1.2</a>. If the version of Axis you are using is older or newer than this version, then this is the wrong documentation to be using. Read the version that came with your copy of Axis.</p>
-
-<a name="DocumentationForAxisUsers"/>
-<section>
-<title>Documentation for Axis Users</title>
+<section name="Documentation">
+
+<p>This is the documentation for <a href="http://ws.apache.org/axis/">Apache Axis 1.4</a>. If the version of Axis you are using is older or newer than this version, then this is the wrong documentation to be using. Read the version that came with your copy of Axis.</p>
+
+<subsection name="Documentation for Axis Users">
 
 <ul>
   <li><a href="install.html">Installation Instructions</a></li>
@@ -26,11 +41,9 @@
   <li><a href="reading.html">Further Reading</a></li>
 </ul>
 
-</section>
+</subsection>
 
-<a name="DocumentationForAxisDevelopers"/>
-<section>
-<title>Documentation for Axis Developers</title>
+<subsection name="Documentation for Axis Developers">
 
 <ul>
   <li><a href="http://ws.apache.org/axis/java/apiDocs/index.html">API Documentation</a></li>
@@ -40,7 +53,7 @@
   <li><a href="architecture-guide.html">Architecture Guide</a> - Axis design concepts and rationale.</li>
 </ul>
 
-</section>
+</subsection>
 
 </section>
 

Copied: axis/axis1/java/trunk/src/site/xdoc/reading.xml (from r1230199, webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/reading.xml)
URL: http://svn.apache.org/viewvc/axis/axis1/java/trunk/src/site/xdoc/reading.xml?p2=axis/axis1/java/trunk/src/site/xdoc/reading.xml&p1=webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/reading.xml&r1=1230199&r2=1230211&rev=1230211&view=diff
==============================================================================
--- webservices/axis/trunk/site/src/java/src/documentation/content/xdocs/java/reading.xml (original)
+++ axis/axis1/java/trunk/src/site/xdoc/reading.xml Wed Jan 11 19:52:05 2012
@@ -1,36 +1,41 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "./dtd/document-v12.dtd">
-<document>
-  <header>
-    <title>WebServices - Axis</title>
-  </header>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one
+  ~ or more contributor license agreements. See the NOTICE file
+  ~ distributed with this work for additional information
+  ~ regarding copyright ownership. The ASF licenses this file
+  ~ to you 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 xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+  <properties>
+    <title>Reading Guide</title>
+  </properties>
   <body>
 
-<a name="RecommendedReading"/>
-<section>
-<title>Recommended Reading</title>
+<section name="Recommended Reading">
 
 <p>Here are things you can read to understand and use Axis better. Remember, you also have access to all the source if you really want to find out how things work (or why they don't).</p>
 
-<a name="TableOfContents"/>
-<section>
-<title>Table of Contents</title>
-
-<ul>
-  <li><a href="#AxisInstallationUseAndInternals">Axis installation, use and internals</a></li>
-  <li><a href="#Specifications">Specifications</a></li>
-  <li><a href="#ExplanationsArticlesAndPresentations">Explanations, articles and presentations</a></li>
-  <li><a href="#Interoperability">Interoperability</a></li>
-  <li><a href="#AdvancedTopics">Advanced topics</a></li>
-  <li><a href="#Books">Books</a></li>
-  <li><a href="#ExternalSitesCoveringWebServices">External Sites covering Web Services</a></li>
-</ul>
+<subsection name="Table of Contents">
 
-</section>
+<macro name="toc"/>
+
+</subsection>
 
-<a name="AxisInstallationUseAndInternals"/>
-<section>
-<title>Axis installation, use and internals</title>
+<subsection name="Axis installation, use and internals">
 
 <ol>
 
@@ -60,13 +65,25 @@ Kevin Jones talks a bit about configurin
 <li><a href="http://www.fawcette.com/javapro/2003_03/online/wsdl_kjones_03_10_03/">Different WSDL Styles in Axis</a><br/>
 Kevin Jones looks at the document and wrapped styles of WSDL2Java bindings.</li>
 
+<li>
+    <a name="ws-sec" href="http://www.j2ee-security.net/book/sample-chap/">Web Services Security with Axis</a><br/>
+    This sample chapter from <a href="http://www.j2ee-security.net/"><i>J2EE Security for Servlets,
+    EJBs and Web Services</i></a> book explains use of username/password based authentication,
+    SSL and Servlet security mechanisms for securing the transport and
+    WS-Security for securing the messages with Apache Axis. To illustrate use of handlers for
+    enforcing security, it describes the implementation of a bare-bones WS-Security mechanism
+    using <a href="http://www.xmltrustcenter.org/developer/verisign/tsik/index.htm">
+    VeriSign's TSIK</a> and JAX-RPC handlers. You can also
+    <a href="http://www.j2ee-security.net/book/viewsource.php">view</a> or
+    <a href="http://www.j2ee-security.net/book/dnldsrc/">download</a> the complete sources
+    discussed in the chapter.
+</li>
+
 </ol>
 
-</section>
+</subsection>
 
-<a name="Specifications"/>
-<section>
-<title>Specifications</title>
+<subsection name="Specifications">
 
 <ol>
 
@@ -95,11 +112,9 @@ JAXM enables applications to send and re
 
 </ol>
 
-</section>
+</subsection>
 
-<a name="ExplanationsArticlesAndPresentations"/>
-<section>
-<title>Explanations, articles and presentations</title>
+<subsection name="Explanations, articles and presentations">
 
 <ol>
 
@@ -129,11 +144,9 @@ A practical but suspiciously code free p
 
 </ol>
 
-</section>
+</subsection>
 
-<a name="Interoperability"/>
-<section>
-<title>Interoperability</title>
+<subsection name="Interoperability">
 
 <ol>
 
@@ -145,11 +158,9 @@ Steve Loughran on interop challenges (es
 
 </ol>
 
-</section>
+</subsection>
 
-<a name="AdvancedTopics"/>
-<section>
-<title>Advanced topics</title>
+<subsection name="Advanced topics">
 
 <ol>
 
@@ -167,15 +178,13 @@ The W3C architects say how things should
 
 </ol>
 
-</section>
+</subsection>
 
-<a name="Books"/>
-<section>
-<title>Books</title>
+<subsection name="Books">
 
 <ol>
 
-<li><i>Beginning Java Web Services</i><br/>
+<li><i><a href="http://www.wrox.com/books/1861007531.htm">Beginning Java Web Services</a></i><br/>
 Meeraj Kunnumpurath et al, Wrox Press, September 2002.<br/>
 An introductory book, with the early chapters focusing on Axis.<br/>
 The <a href="http://www.wrox.com/books/sample-chapters/SampleChapter_1861007531.pdf">sample chapter</a> shows how to install Axis with Tomcat 4.0:
@@ -195,24 +204,45 @@ It is based on Beta-1. This is a reasona
 Steve Graham et al, December 2001.<br/>
 Covering very early versions of Axis along with other aspects of Web Service technologies. One of the authors, Glen Daniels, is an Axis committer and active contributor, so the quality of the Axis coverage is high. Good explanations of SOAP, UDDI, and the like.</li>
 
+<li>
+    <a href="http://www.j2ee-security.net">
+    <i>J2EE Security for Servlets, EJBs and Web Services</i></a><br/>
+    Pankaj Kumar, Prentice Hall, September 2003.<br/>
+    A book on using Java security APIs, tools and mechanisms for building secure
+    enterprise applications. The chapter on <a href="#ws-sec">Web Services Security</a>
+    uses Axis-1.1RC1
+    for illustrations. Besides Web Services, it covers security aspects of Java RMI,
+    Servlet and JSP based Web Applications and EJBs.
+</li>
+
 </ol>
 
 <p>Authors, publishers: we welcome additions to this section of any books which have some explicit coverage of Axis. Free paper/pdf copies and other forms of bribery accepted.</p>
 
-</section>
+</subsection>
 
-<a name="ExternalSitesCoveringWebServices"/>
-<section>
-<title>External Sites covering Web Services</title>
+<subsection name="External Sites covering Web Services">
 
 <ol>
 
 <li><a href="http://www-106.ibm.com/developerworks/webservices/">IBM developerWorks Web Services corner</a><br/>
 There are lots of interesting articles on Web Services here, many of which are Axis related. There is also a <a href="http://www-106.ibm.com/developerworks/webservices/library/ws-spec.html">listing of</a> "all current open standards and specifications that define the Web services family of protocols", though Soap with Attachments is mysteriously absent.</li>
 
+<li>
+    <a href="http://msdn.microsoft.com/webservices/">MSDN Web
+    Services</a><br/>
+    These are the microsoft pages; little Axis coverage but plenty on 
+    Web Service specifications.
+</li>
+
+<li><a href="http://webservices.xml.com/">WebServices.xml.com</a>
+The O'Reilly site is always up to date, interesting and useful. It
+doesn't advocate a single technology (REST, SOAP, RDF...), or a single
+product. As such, it retains its independence and value.</li>
+
 </ol>
 
-</section>
+</subsection>
 
 </section>