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 st...@apache.org on 2002/08/28 00:47:22 UTC
cvs commit: xml-axis/java/docs axis-bibliography.bib reading.html index.html user-guide.html
stevel 2002/08/27 15:47:21
Modified: java/docs index.html user-guide.html
Added: java/docs axis-bibliography.bib reading.html
Log:
added reading list web page (and more detailed .bib for latex users)...maybe we could have some XML metaformat (RDF?) and XSLT out everything. More contribs welcome.
Revision Changes Path
1.6 +3 -0 xml-axis/java/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-axis/java/docs/index.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- index.html 22 Jan 2002 15:35:11 -0000 1.5
+++ index.html 27 Aug 2002 22:47:21 -0000 1.6
@@ -30,6 +30,9 @@
<a href="user-guide.html">User's Guide</a></li>
<li>
+<a href="reading.html">Further Reading</a></li>
+
+<li>
Development Documention</li>
<ul>
1.66 +13 -13 xml-axis/java/docs/user-guide.html
Index: user-guide.html
===================================================================
RCS file: /home/cvs/xml-axis/java/docs/user-guide.html,v
retrieving revision 1.65
retrieving revision 1.66
diff -u -r1.65 -r1.66
--- user-guide.html 27 Aug 2002 19:23:42 -0000 1.65
+++ user-guide.html 27 Aug 2002 22:47:21 -0000 1.66
@@ -2,9 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <meta name="GENERATOR" content="Mozilla/4.73 [en] (WinNT; U) [Netscape]">
<title>Axis User's Guide</title>
-<!-- saved from url=(0022)http://internet.e-mail -->
<style type="text/css">
<!--
.example { background:#ccccff }
@@ -24,7 +22,7 @@
<h1>
Axis User's Guide</h1>
-<i>Beta 2 Version</i>
+<i>Post Beta 3 Version</i>
<h3>
Table of Contents</h3>
@@ -580,14 +578,14 @@
<h5>Unsigned data</h5>
You cannot consume or generate services that use unsigned datatypes with
-JAX-RPC or Axis. This can be an issue if you are consuming Web Services
-written in other languages, or implementing a service against a WSDL
-specification or XSD schema that uses them. Axis may add support for
-unsigned datatypes if we can come up with an elegant solution and
-somebody (it could be you...) invests the time to implement it, or when
-a revision of JAX-RPC adds this. The fundamental problem is of course
-the lack of unsigned datatypes in Java.
-
+pure JAX-RPC, because there are no unsigned dataypes in Java.
+<p>
+Axis does have support for the unsigned types, so you can consume services
+written in C++, C# and the like, and re-implement interfaces designed for
+those languages. Be very wary about exporting unsigned datatypes, however, as to
+do so will stop Java clients that do not use Axis or another SOAP client library
+with unsigned support from using them. At least, until
+a revision of JAX-RPC adds this.
<h5>Arbitrary Objects without registration</h5>
@@ -1222,7 +1220,9 @@
<p>The current list of published interfaces is as follows:
<ul>
<li>
-JAX-RPC interfaces. At the time of this writing, JAX-RPC is still in the public review stage of its existence, meaning that it may still change. As it does, the JAX-RPC interfaces may also change. JAX-RPC is expected to become official some time during the summer of 2002.
+JAX-RPC interfaces.
+These interfaces are from JAX-RPC 1.0 specification, and will change only when
+new versions of the specification are released.
<ul>
<li>javax.xml.messaging.Endpoint</li>
<li>javax.xml.messaging.URLEndpoint</li>
@@ -1279,7 +1279,7 @@
<li>javax.xml.transform.Source</li>
</ul>
</li>
-<li>AXIS interfaces:
+<li>AXIS interfaces. These have less guarantees of stability:
<ul>
<li>org.apache.axis.AxisFault</li>
<li>org.apache.axis.Handler</li>
1.1 xml-axis/java/docs/axis-bibliography.bib
Index: axis-bibliography.bib
===================================================================
@article{winer:xmlrpc,
title="{XML-RPC}",
author="Dave Winer",
year=2000,
institution="UserLand",
url="http://www.xmlrpc.com/spec",
note="\href{http://www.xmlrpc.com/spec}{http://www.xmlrpc.com/spec}"
}
@inproceedings{indiana:rmiperf,
title="Requirements for and Evaluation of {RMI} Protocols for Scientific Computing",
author="Madhusudhan Govindaraju and others",
institution="Department of Computer Science Indiana University",
url="http://www.extreme.indiana.edu/xgws/papers/sc00_paper/index.html",
year="2000",
booktitle="Proceedings Supercomputing 2000",
note="\href{http://www.extreme.indiana.edu/xgws/papers/sc00_paper/index.html}{http://www.extreme.indiana.edu/xgws/papers/sc00_paper/index.html}"
}
@inproceedings{indiana:soap-limits,
title="Investigating the Limits of {SOAP} Performance for Scientific Computing"
author="Kenneth Chiu and Madhusudhan Govindaraju and Randall Bramley",
booktitle="Proceedings of HPDC 2002",
year=2002,
url="http://www.extreme.indiana.edu/xgws/papers/soap-hpdc2002/soap-hpdc2002.pdf"
}
@techreport{ruby:infinity,
title="To infinity and beyond - the quest for {SOAP} interoperability",
author="Sam Ruby",
year=2002,
url="http://radio.weblogs.com/0101679/stories/2002/02/01/toInfinityAndBeyondTheQuestForSoapInteroperability.html",
note="\href{http://radio.weblogs.com/0101679/stories/2002/02/01/toInfinityAndBeyondTheQuestForSoapInteroperability.html}{http://radio.weblogs.com/0101679/stories/2002/02/01/toInfinityAndBeyondTheQuestForSoapInteroperability.html}"
}
@misc{ruby:gump,
title="The Gump",
author="Sam Ruby",
year=2001,
url="http://jakarta.apache.org/gump/"
}
@misc{ruby:wsdl1.1guide,
title="A Busy Developer's Guide to {WSDL 1.1}",
author="Sam Ruby",
year=2002,
url="http://radio.weblogs.com/0101679/stories/2002/02/15/aBusyDevelopersGuideToWsdl11.html"
}
@misc{ruby:soap-intro,
title="A Gentle Introduction to {SOAP}",
author="Sam Ruby",
year=2002,
url="http://radio.weblogs.com/0101679/stories/2002/03/16/aGentleIntroductionToSoap.html"
}
@techreport{spec:SOAP1.1,
title="{SOAP} Version 1.1",
institution="W3C",
author="W3C",
year=2001,
url="http://www.w3.org/TR/SOAP/"
note="\href{http://www.w3.org/TR/SOAP/}{http://www.w3.org/TR/SOAP/}"
}
@techreport{spec:SOAP1.2,
title="{SOAP} Version 1.2 Part 0: Primer",
institution="W3C",
author="W3C",
year=2002,
url="http://www.w3.org/TR/soap12-part0/"
note="\href{http://www.w3.org/TR/soap12-part0/}{http://www.w3.org/TR/soap12-part0/}"
}
@techreport{spec:WSDL1.1,
title="{Web Services Description Language (WSDL) 1.1}",
institution="W3C",
author="W3C",
year=2002,
url="http://www.w3.org/TR/wsdl",
note="\href{http://www.w3.org/TR/wsdl}{http://www.w3.org/TR/wsdl}"
}
@manual{apache:axis,
title="{Apache Axis}",
year="2001",
url="http://xml.apache.org/axis/",
institution="Apache"
}
@techreport{ietf:rfc2616,
title="{RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1}",
author="Fielding, R., Gettys, J., Mogul, J., Frysyk, H., Masinter, L., Leach, P. and Berners-Lee, T.",
institution="IETF",
url="http://ietf.org/rfc/rfc2616.txt"
}
@book{loughran:antbook,
author="Erik Hatcher, Steve Loughran",
publisher="Manning press",
title="{Java} Development With {Ant}",
year="2003",
url="http://manning.com/antbook"
}
@phdthesis{fielding:rest,
author= "Roy Thomas Fielding",
title = "Architectural Styles and the Design of Network-based Software Architectures",
year = 2000,
school = "University of California",
type = "{Ph.D.} dissertation",
url="http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm",
}
@manual{spec:JAX-RPC,
institution="Java Community Process",
title="{JAX-RPC} Specification",
edition="1.0",
note="\href{http://java.sun.com/xml/downloads/jaxrpc.html}{http://java.sun.com/xml/downloads/jaxrpc.html}",
url="http://java.sun.com/xml/downloads/jaxrpc.html"
}
1.1 xml-axis/java/docs/reading.html
Index: reading.html
===================================================================
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Axis User's Guide</title>
<style type="text/css">
<!--
.example { background:#ccccff }
.xml { background:#eeeeee }
body { font-family: Verdana, Arial, Helvetica, sans-serif; margin-left: 40px}
h2 { text-decoration: underline; background-color: #DCE1FF; background-position: left; margin-left: -30px}
h3 { margin-left: -10px}
h1 { margin-left: -30px}
-->
</style>
</head>
<body text="#000000" bgcolor="#FFFFFF">
<center>
<h1>
<img SRC="axis.jpg" height=96 width=176></h1></center>
<h1>Recommended Reading</h1>
<h2>Specifications</h2>
<ol>
<li>
<a href="http://www.w3.org/TR/SOAP/">
SOAP Version 1.1
</a>
</li>
<li>
<a href="http://www.w3.org/TR/soap12-part0/">
SOAP Version 1.2 Part 0: Primer
</a>
</li>
<li>
<a href="http://www.w3.org/TR/wsdl">
Web Services Description Language (WSDL) 1.1
</a>
</li>
<li>
<a href="http://ietf.org/rfc/rfc2616.txt">
RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1
</a>
</li>
<li>
<a href="http://java.sun.com/xml/downloads/jaxrpc.html">
JAX-RPC Specification 1.0
</a>
</li>
</ol>
<h2>Explanations, articles and presentations</h2>
<ol>
<li>
<a href="http://radio.weblogs.com/0101679/stories/2002/03/16/aGentleIntroductionToSoap.html">
A Gentle Introduction to SOAP
</a>
</li>
<li>
<a href="http://radio.weblogs.com/0101679/stories/2002/02/15/aBusyDevelopersGuideToWsdl11.html">
A Busy Developer's Guide to WSDL 1.1
</a>
</li>
<li>
<a href="http://radio.weblogs.com/0101679/stories/2002/02/01/toInfinityAndBeyondTheQuestForSoapInteroperability.html">
To infinity and beyond - the quest for SOAP interoperability
</a>
</li>
<li>
<a href="http://manning.com/antbook">
Java develoment with Ant (chapter 15)
</a>
</li>
<li>
<a href="http://www.iseran.com/Steve/papers/when_web_services_go_bad.html">
When Web Services Go Bad
</a>
</li>
<li>
<a href="http://servlet.java.sun.com/javaone/sf2002/conf/sessions/index.en.jsp">
JavaOne 2002,Web Services Today and Tomorrow </a>
(Java Developer connection login required)
</li>
</ol>
<h2>Advanced topics</h2>
<ol>
<li>
<a href="http://www.extreme.indiana.edu/xgws/papers/sc00_paper/index.html">
Requirements for and Evaluation of RMI Protocols for Scientific Computing
</a>
</li>
<li>
<a href="http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm">
Architectural Styles and the Design of Network-based Software Architectures
</a>
</li>
<li>
<a href="http://www.extreme.indiana.edu/xgws/papers/soap-hpdc2002/soap-hpdc2002.pdf">
Investigating the Limits of SOAP Performance for Scientific Computing
</a>
</li>
</ol>