You are viewing a plain text version of this content. The canonical link for it is here.
Posted to taglibs-dev@jakarta.apache.org by js...@apache.org on 2001/07/24 19:59:09 UTC
cvs commit: jakarta-taglibs/io/xml io.xml
jstrachan 01/07/24 10:59:09
Modified: io build.xml
io/examples/web index.jsp quote.jsp
io/examples/web/test file_write.jsp test_pipe.jsp
test_pipe2.jsp
io/xml io.xml
Removed: io/doc/web changes.xml
Log:
First port of new build process
Revision Changes Path
1.6 +2 -2 jakarta-taglibs/io/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/build.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- build.xml 2001/07/01 20:08:23 1.5
+++ build.xml 2001/07/24 17:59:08 1.6
@@ -6,8 +6,8 @@
<project name="io" default="main">
- <property name="gen-docs.present" value="true"/>
-
+ <property name="disable.examples.html" value="true"/>
+
&common;
</project>
1.2 +11 -11 jakarta-taglibs/io/examples/web/index.jsp
Index: index.jsp
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/examples/web/index.jsp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.jsp 2001/05/04 18:07:19 1.1
+++ index.jsp 2001/07/24 17:59:08 1.2
@@ -19,10 +19,10 @@
<ul>
<li><a href="file.jsp">load a file via the file system</a></li>
- <li><a href="file_write.jsp">write a temporary file from the content of a HTTP request then read it back again.</a></li>
- <li><a href="ftp.jsp">load a file via FTP</a></li>
<li><a href="jakarta.jsp">load the Jakarta Home Page via HTTP</a></li>
<li><a href="quote.jsp?symbols=SUNW+IBM">get XML Stock Quotes via HTTP</a></li>
+ <li><a href="file_write.jsp">write a temporary file from the content of a HTTP request then read it back again.</a></li>
+ <li><a href="ftp.jsp">load a file via FTP</a></li>
</ul>
@@ -57,15 +57,6 @@
web services and return XML documents ready for styling into some other format.
</p>
-<h3>General</h3>
-
-<ul>
- <li><a href="soap.jsp">Sample SOAP request echo</a></li>
- <li><a href="soap/fortune.jsp">Fortune cookie</a></li>
- <li><a href="soap/babelfish.jsp">Babelfish</a></li>
- <li><a href="soap/babelfish2.jsp">Babelfish (alternative)</a></li>
-</ul>
-
<h3>MarketWatch</h3>
<ul>
@@ -73,6 +64,15 @@
<li><a href="marketwatch/news_headlines.jsp">News Headlines</a></li>
<li><a href="marketwatch/quote.jsp">Quote</a></li>
<li><a href="marketwatch/symbol_info.jsp">Symbol Information</a></li>
+</ul>
+
+<h3>General</h3>
+
+<ul>
+ <li><a href="soap.jsp">Sample SOAP request echo</a></li>
+ <li><a href="soap/babelfish.jsp">Babelfish</a></li>
+ <li><a href="soap/babelfish2.jsp">Babelfish (alternative)</a></li>
+ <li><a href="soap/fortune.jsp">Fortune cookie</a></li>
</ul>
<hr align="center" width="60%" />
1.3 +1 -2 jakarta-taglibs/io/examples/web/quote.jsp
Index: quote.jsp
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/examples/web/quote.jsp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- quote.jsp 2001/05/05 17:18:20 1.2
+++ quote.jsp 2001/07/24 17:59:08 1.3
@@ -1,6 +1,5 @@
<%@page contentType="text/xml" %>
<%@taglib uri="http://jakarta.apache.org/taglibs/io-1.0" prefix="io" %>
-<?xml version="1.0" ?>
<%
String url = request.getParameter( "symbols" );
if ( url == null ) {
@@ -12,4 +11,4 @@
%>
<io:http url="http://www.xmltoday.com/examples/stockquote/getxmlquote.vep">
<io:param name="s"><%= url %></io:param>
-</io:http>
+</io:http>
\ No newline at end of file
1.3 +1 -1 jakarta-taglibs/io/examples/web/test/file_write.jsp
Index: file_write.jsp
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/examples/web/test/file_write.jsp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- file_write.jsp 2001/05/05 17:18:26 1.2
+++ file_write.jsp 2001/07/24 17:59:08 1.3
@@ -1,10 +1,10 @@
+<html>
<%@taglib uri="http://jakarta.apache.org/taglibs/io-1.0" prefix="io" %>
<%--
Serves up a file via file system
--%>
-<html>
<body>
<h1>Fetch a file from FTP and write to the local file system</h1>
<p>
1.3 +1 -1 jakarta-taglibs/io/examples/web/test/test_pipe.jsp
Index: test_pipe.jsp
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/examples/web/test/test_pipe.jsp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- test_pipe.jsp 2001/05/05 17:18:26 1.2
+++ test_pipe.jsp 2001/07/24 17:59:08 1.3
@@ -1,3 +1,4 @@
+<html>
<%@taglib uri="http://jakarta.apache.org/taglibs/io-1.0" prefix="io" %>
<%--
@@ -8,7 +9,6 @@
String s = "This is some sample text to test";
pageContext.setAttribute( "data", s );
%>
-<html>
<body>
<h2>Pipe test</h2>
1.3 +1 -1 jakarta-taglibs/io/examples/web/test/test_pipe2.jsp
Index: test_pipe2.jsp
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/examples/web/test/test_pipe2.jsp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- test_pipe2.jsp 2001/05/05 17:18:26 1.2
+++ test_pipe2.jsp 2001/07/24 17:59:08 1.3
@@ -1,10 +1,10 @@
+<html>
<%@taglib uri="http://jakarta.apache.org/taglibs/io-1.0" prefix="io" %>
<%--
Tests the behaviour of the <io:pipe> tag using an internal IO request
--%>
-<html>
<body>
<h2>Pipe test #2</h2>
1.4 +155 -139 jakarta-taglibs/io/xml/io.xml
Index: io.xml
===================================================================
RCS file: /home/cvs/jakarta-taglibs/io/xml/io.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- io.xml 2001/05/10 11:37:47 1.3
+++ io.xml 2001/07/24 17:59:09 1.4
@@ -5,15 +5,19 @@
<author>James Strachan</author>
</properties>
<taglib>
- <tlibversion>1.0</tlibversion>
- <jspversion>1.1</jspversion>
- <shortname>io</shortname>
- <taglib-location>/WEB-INF/io.tld</taglib-location>
- <uri>WEB-INF/io.tld</uri>
- <prefix>io</prefix>
- <info>IO Tag library</info>
- <overview>
+ <tlib-version>1.0</tlib-version>
+ <!-- Minimum version of JSP spec required -->
+ <jsp-version>1.1</jsp-version>
+ <!-- jakarta-taglib name of this tag library -->
+ <short-name>io</short-name>
+ <!-- URI of taglib -->
+ <uri>http://jakarta.apache.org/taglibs/io-1.0</uri>
+ <!-- The name to use in titles, etc. for the taglib -->
+ <display-name>IO Tag library: Tags for working with FTP, HTTP, HTTPS, XML-RPC and SOAP</display-name>
+
+ <description>
+
<p>
The IO library allows URLs and HTTP requests to be performed using JSP
custom tags. This allows JSP to be used to perform HTTP GETs or PUT
@@ -443,114 +447,43 @@
browser.
</p>
- </overview>
+</description>
- <requirements-info>
- This custom tag library requires no software other than a servlet container
- that supports the JavaServer Pages Specification, version 1.1 or higher.
- </requirements-info>
+ <!-- The following elements are for JSP 1.2 tag libraries only,
+ and are not used for generating documentation yet.
- <!-- pipe tag -->
- <tag>
- <name>pipe</name>
- <tagclass>org.apache.taglibs.io.PipeTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
- Acts like a Unix pipe between tags that are not capable of piping themselves.
- A pipe can take some input or some output or both.
- If no input is specified then its body content is used.
- If no output is specified then the current output is used.
- </info>
- <script-variable>No</script-variable>
- <attribute>
- <name>reader</name>
- <required>false</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- <attribute>
- <name>writer</name>
- <required>false</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- <restrictions></restrictions>
- <usage>
- <comment>
- </comment>
- <code><![CDATA[
-<io:pipe input="<%= request.getReader() %>"/>
-]]></code>
- </usage>
- </tag>
+ <validator>
- <!-- set tag -->
- <tag>
- <name>set</name>
- <tagclass>org.apache.taglibs.io.SetTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
- Sets the property on its parent tag.
- Either the body of this tag is used as the value or a PipeConsumer
- can be included in my body.
- </info>
- <script-variable>No</script-variable>
- <attribute>
- <name>property</name>
- <required>true</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- <attribute>
- <name>reader</name>
- <required>false</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- <restrictions></restrictions>
- <usage>
- <comment>
- </comment>
- <code><![CDATA[
-<io:set name="url">some text with mixed tags & expressions</io:set>
-]]></code>
- </usage>
- </tag>
+ </validator>
+ <listener>
- <!-- get tag -->
- <tag>
- <name>get</name>
- <tagclass>org.apache.taglibs.io.GetTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
- Returns the bean or bean property and pipes it into its parent PipeConsumer tag.
- </info>
- <script-variable>No</script-variable>
- <attribute>
- <name>name</name>
- <required>true</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- <attribute>
- <name>property</name>
- <required>false</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- <restrictions></restrictions>
- <usage>
- <comment>
- </comment>
- <code><![CDATA[
-<io:get name="something" property"bar"/>
-]]></code>
- </usage>
- </tag>
+ </listener>
+ -->
-
+ <!-- The taglib-location is used to fill in the web.xml configuration
+ information in the HTML doc. -->
+ <taglib-location>/WEB-INF/io.tld</taglib-location>
+
+ <!-- The prefix is used to fill in the taglib directive
+ configuration information in the HTML doc. -->
+ <prefix>io</prefix>
+
+
+ <requirements-description>
+ This custom tag library requires no software other than a servlet container
+ that supports the JavaServer Pages Specification, version 1.1 or higher.
+ </requirements-description>
+
+ <tagtoc name="IO Tags">
+
<!-- request tag -->
<tag>
<name>request</name>
- <tagclass>org.apache.taglibs.io.URLTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
+ <tag-class>org.apache.taglibs.io.URLTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
Requests the content of the given URL.
- </info>
+ </description>
<attribute>
<name>url</name>
<required>true</required>
@@ -567,24 +500,24 @@
<rtexprvalue>true</rtexprvalue>
</attribute>
<restrictions>None</restrictions>
- <usage>
+ <example><usage>
<comment>
</comment>
<code><![CDATA[
<io:url url="/WEB-INF/foo.xml"/>
]]></code>
- </usage>
+ </usage></example>
</tag>
<!-- http tag -->
<tag>
<name>http</name>
- <tagclass>org.apache.taglibs.io.HttpTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
+ <tag-class>org.apache.taglibs.io.HttpTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
Performs a HTTP request on the given URL with the specified action and optional body.
If no action is specified then it defaults to "GET".
- </info>
+ </description>
<attribute>
<name>url</name>
<required>true</required>
@@ -597,25 +530,25 @@
</attribute>
<script-variable>No</script-variable>
<restrictions>None</restrictions>
- <usage>
+ <example><usage>
<comment>
</comment>
<code><![CDATA[
<io:http url="http://jakarta.apache.org" action="GET"/>
]]></code>
- </usage>
+ </usage></example>
</tag>
<!-- header tag -->
<tag>
<name>header</name>
- <tagclass>org.apache.taglibs.io.URLHeaderTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
+ <tag-class>org.apache.taglibs.io.URLHeaderTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
Defines a URL / HTTP header for the current request tag.
The value of the header can be specified as an attribute
otherwise the value of the tags body is taken instead.
- </info>
+ </description>
<attribute>
<name>name</name>
<required>true</required>
@@ -628,7 +561,7 @@
</attribute>
<script-variable>No</script-variable>
<restrictions>None</restrictions>
- <usage>
+ <example><usage>
<comment>
</comment>
<code><![CDATA[
@@ -636,19 +569,19 @@
<io:header name="Content-Type" value="text/xml"/>
</io:http>
]]></code>
- </usage>
+ </usage></example>
</tag>
<!-- param tag -->
<tag>
<name>param</name>
- <tagclass>org.apache.taglibs.io.URLParameterTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
+ <tag-class>org.apache.taglibs.io.URLParameterTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
Defines a query argument for the URL of the current request.
The value of the parameter can be specified as an attribute
otherwise the value of the tags body is taken instead.
- </info>
+ </description>
<attribute>
<name>name</name>
<required>true</required>
@@ -661,7 +594,7 @@
</attribute>
<script-variable>No</script-variable>
<restrictions>Must be specified before any <http:header> or <http:body> tags</restrictions>
- <usage>
+ <example><usage>
<comment>
</comment>
<code><![CDATA[
@@ -669,17 +602,17 @@
<io:header name="Content-Type" value="text/xml"/>
</io:http>
]]></code>
- </usage>
+ </usage></example>
</tag>
<!-- soap tag -->
<tag>
<name>soap</name>
- <tagclass>org.apache.taglibs.io.HttpSoapTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
+ <tag-class>org.apache.taglibs.io.HttpSoapTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
Performs a HTTP SOAP request on the given URL, SOAPAction and body.
- </info>
+ </description>
<attribute>
<name>url</name>
<required>true</required>
@@ -692,7 +625,7 @@
</attribute>
<script-variable>No</script-variable>
<restrictions>None</restrictions>
- <usage>
+ <example><usage>
<comment>
</comment>
<code><![CDATA[
@@ -713,17 +646,17 @@
</io:body>
</io:soap>
]]></code>
- </usage>
+ </usage></example>
</tag>
<!-- xmlrpc tag -->
<tag>
<name>xmlrpc</name>
- <tagclass>org.apache.taglibs.io.XmlRpcTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <info>
+ <tag-class>org.apache.taglibs.io.XmlRpcTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
Performs an XML RPC request on the given URL.
- </info>
+ </description>
<attribute>
<name>url</name>
<required>true</required>
@@ -736,7 +669,7 @@
</attribute>
<script-variable>No</script-variable>
<restrictions>None</restrictions>
- <usage>
+ <example><usage>
<comment>
</comment>
<code><![CDATA[
@@ -754,8 +687,91 @@
</io:body>
</io:xmlrpc>
]]></code>
- </usage>
+ </usage></example>
</tag>
+ <!-- pipe tag -->
+ <tag>
+ <name>pipe</name>
+ <tag-class>org.apache.taglibs.io.PipeTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
+ Acts like a Unix pipe between tags that are not capable of piping themselves.
+ A pipe can take some input or some output or both.
+ If no input is specified then its body content is used.
+ If no output is specified then the current output is used.
+ </description>
+ <script-variable>No</script-variable>
+ <attribute>
+ <name>reader</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ </attribute>
+ <attribute>
+ <name>writer</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ </attribute>
+ <restrictions></restrictions>
+ <example><usage>
+ <comment>
+ </comment>
+ <code><![CDATA[
+<io:pipe input="<%= request.getReader() %>"/>
+]]></code>
+ </usage></example>
+ </tag>
+
+ <!-- get tag -->
+ <tag>
+ <name>get</name>
+ <tag-class>org.apache.taglibs.io.GetTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
+ Returns the bean or bean property and pipes it into its parent PipeConsumer tag.
+ </description>
+ <script-variable>No</script-variable>
+ <attribute>
+ <name>name</name>
+ <required>true</required>
+ <rtexprvalue>true</rtexprvalue>
+ </attribute>
+ <attribute>
+ <name>property</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ </attribute>
+ <restrictions></restrictions>
+ <example><usage>
+ <comment>
+ </comment>
+ <code><![CDATA[
+<io:get name="something" property"bar"/>
+]]></code>
+ </usage></example>
+ </tag>
+ </tagtoc>
</taglib>
+
+
+
+<revision release="Pre Beta" date="07/24/2001">
+ <description>
+ Clean up of tag library prior to performing a beta
+ release, moving toward an official release.
+ </description>
+ <section name="Tag removed">
+ <item>
+ The <io:set> tag has been removed since it appears that
+ tags are not allowed to set properties on their outer tags as this
+ breaks the JSP 1.2 spec.
+ </item>
+ </section>
+</revision>
+
+<revision release="Initial version" date="03/03/2000">
+ <description>Initial check into CVS.
+ </description>
+</revision>
+
</document>