[jbossws-commits] JBossWS SVN: r1578 - in trunk/docs/online/tutorial-doc/en/modules: . installation

Author: sam.griffith(a)jboss.com Date: 2006-12-06 10:30:26 -0500 (Wed, 06 Dec 2006) New Revision: 1578 Added: trunk/docs/online/tutorial-doc/en/modules/installation/install-on-jboss-5.xml trunk/docs/online/tutorial-doc/en/modules/what-is-a-web-service.xml Removed: trunk/docs/online/tutorial-doc/en/modules/attachments/ trunk/docs/online/tutorial-doc/en/modules/clients/ trunk/docs/online/tutorial-doc/en/modules/endpoints/ trunk/docs/online/tutorial-doc/en/modules/exceptions/ trunk/docs/online/tutorial-doc/en/modules/headers-handlers/ trunk/docs/online/tutorial-doc/en/modules/holders/ trunk/docs/online/tutorial-doc/en/modules/installation/install-tomcat.xml trunk/docs/online/tutorial-doc/en/modules/jmstransport/ trunk/docs/online/tutorial-doc/en/modules/mtom-xop/ trunk/docs/online/tutorial-doc/en/modules/oneway/ trunk/docs/online/tutorial-doc/en/modules/secureejb/ trunk/docs/online/tutorial-doc/en/modules/wsaddressing/ trunk/docs/online/tutorial-doc/en/modules/wseventing/ trunk/docs/online/tutorial-doc/en/modules/wssecurity/ trunk/docs/online/tutorial-doc/en/modules/wstransaction/ trunk/docs/online/tutorial-doc/en/modules/xmlregistry/ Log: Added: trunk/docs/online/tutorial-doc/en/modules/installation/install-on-jboss-5.xml =================================================================== --- trunk/docs/online/tutorial-doc/en/modules/installation/install-on-jboss-5.xml 2006-12-06 15:25:10 UTC (rev 1577) +++ trunk/docs/online/tutorial-doc/en/modules/installation/install-on-jboss-5.xml 2006-12-06 15:30:26 UTC (rev 1578) @@ -0,0 +1,16 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<sect2 id="install-on-jboss-5"> + + <title>Installation on JBoss Application Server 5</title> + + <para> + If you are using a beta of JBoss Application Server 5, you do not need to install anything as + the JBoss Web Service JAX-WS 2.0 stack is included already. + </para> + +<!-- + <para>Additionally, please have a look at the <ulink url="http://labs.jboss.com/jbossws/user-guide/en/Install.txt"&g... specific install instructions</ulink>.</para> +--> + +</sect2> Deleted: trunk/docs/online/tutorial-doc/en/modules/installation/install-tomcat.xml =================================================================== --- trunk/docs/online/tutorial-doc/en/modules/installation/install-tomcat.xml 2006-12-06 15:25:10 UTC (rev 1577) +++ trunk/docs/online/tutorial-doc/en/modules/installation/install-tomcat.xml 2006-12-06 15:30:26 UTC (rev 1578) @@ -1,69 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<!-- $Id: install-tomcat.xml 1495 2006-11-21 20:29:19Z thomas.diesler(a)jboss.com $ --> - -<sect1 id="install-tomcat"> - - <title>Install on Apache Tomcat</title> - - <para>If you have an existing application on Tomcat that has a need for web service support, you can still use JBossWS. This - allows you to develop standard portable J2EE-1.4 web service endpoints in Tomcat that can be moved unmodified to JBossAS when needed. - New applications should consider JBoss with ebedded Tomcat for a number of good reasons. </para> - - <para>For additional information, see <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=TomcatStandalonevsEmbe... Standalone vs Embedded</ulink>.</para> - - <para>JBoss Inc. provides subscription support contracts for both Tomcat Standalone and JBoss embedded Tomcat.</para> - - <para>To install JBossWS on Tomcat you need to</para> - - <itemizedlist> - <listitem> - <para> - Copy serializer.jar, xalan.jar, xercesImpl.jar to ${tomcat.home}/common/endorsed. This overrides the XML parser that comes with - the JDK with a more recent version that is compatible with JBossWS. - </para> - </listitem> - <listitem> - <para> - Copy activation.jar, mailapi.jar, log4j.jar to ${tomcat.home}/common/lib. - </para> - </listitem> - <listitem> - <para> - Copy jbossws-core.jar, jbossws-tomcat-integration.jar, jbossws-thirdparty.jar to ${tomcat.home}/common/lib. - </para> - </listitem> - <listitem> - <para> - Copy jbossws.war to ${tomcat.home}/webapps. - </para> - </listitem> - </itemizedlist> - - <para>There is no jdk1.4 version available for Tomcat.</para> - - <para>When the jbossws web application context stats up, it creates a ${tomcat.home}/jbossws-deploy directory next to ${tomcat.home}/webapps. - This is the hot deployment directory equivalent to ${jboss.home}/server/default/deploy. Web service endpoints that you drop in ${tomcat.home}/jbossws-deploy - are converted into valid web applications and copied over to ${tomcat.home}/webapps</para> - - <para>Only POJO endpoints are supported. EJB endpoints are not supported in Tomcat standalone for obvious resons. Also note, that POJO endpoints - are currently not pooled, hence you get a new instance for ever invocation. The packaging of a standard portable J2EE-1.4 web service endpoints - is defined by the JSR109 specification. JBossWS also supports JSR181 endpoints, which are significantly easier to develop and maintain.</para> - - <para>To run the samples that come with this JBossWS release against Tomcat, you must enable access to the Tomcat Manager in ${tomcat.home}/conf/tomcat-users.xml - For details of this see <ulink url="http://tomcat.apache.org/tomcat-5.5-doc/manager-howto.html#Conf... Manager Application Access</ulink> - in the Tomcat documentation.</para> - - <para>Here is a example</para> - - <para> - <programlisting><![CDATA[ - <tomcat-users> - <role rolename="manager"/> - <user username="manager" password="manager" roles="manager"/> - </tomcat-users> - ]]></programlisting></para> - - <para>Additionally, please have a look at the <ulink url="http://labs.jboss.com/jbossws/user-guide/en/Install.txt"&g... specific install instructions</ulink>.</para> - -</sect1> Added: trunk/docs/online/tutorial-doc/en/modules/what-is-a-web-service.xml =================================================================== --- trunk/docs/online/tutorial-doc/en/modules/what-is-a-web-service.xml 2006-12-06 15:25:10 UTC (rev 1577) +++ trunk/docs/online/tutorial-doc/en/modules/what-is-a-web-service.xml 2006-12-06 15:30:26 UTC (rev 1578) @@ -0,0 +1,36 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<sect1 id="what-is-a-web-service"> + + <title>What is a Web Service?</title> + + <para> + Several approaches over the years (CORBA, DCOM, DSOM, RPC) aimed at providing distributed + processing in a standardized manner have lead us to today's Web + Services approach. It is built on XML which is multinational, human readable, platform + independent and allows the expression and manipulation of very complicated data structures. + Both the SOAP and RESTful web service approaches use XML to do the data transfer between + the client and server distibuted processes. + </para> + + <para> + While there are several different approaches to web services. The most common approach is + embodied in the SOAP based web services specs and frameworks (now W3C specs) created jointly + between IBM and Microsoft. They are a very rich set of specs, but along with that richness comes a lot + of complexity aimed at dealing with many different kinds of scenerios. There is also the + RESTful approach as well which tends to be more bare-bones and avoids dealing with many of + the issues that the covered in the W3C specs. + </para> + + <para> + The common reality of each of these approaches is being able to call + some distributed (either remotely or on the same machine) + process to get it to do some work for you and then return the results. + So web services may best defined in this simple way: + <quote> + Web Services provide ability to call distributed behavior and receive + results in a platform independent and well understood format. + </quote> + </para> + +</sect1> \ No newline at end of file