You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by bu...@apache.org on 2005/01/31 00:04:43 UTC

svn commit: r149181 - in jakarta/commons/sandbox/feedparser/trunk: src/java/org/apache/commons/feedparser/FeedVersion.java xdocs/index.xml

Author: burton
Date: Sun Jan 30 15:04:42 2005
New Revision: 149181

URL: http://svn.apache.org/viewcvs?view=rev&rev=149181
Log:
...

Modified:
    jakarta/commons/sandbox/feedparser/trunk/src/java/org/apache/commons/feedparser/FeedVersion.java
    jakarta/commons/sandbox/feedparser/trunk/xdocs/index.xml

Modified: jakarta/commons/sandbox/feedparser/trunk/src/java/org/apache/commons/feedparser/FeedVersion.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/feedparser/trunk/src/java/org/apache/commons/feedparser/FeedVersion.java?view=diff&r1=149180&r2=149181
==============================================================================
--- jakarta/commons/sandbox/feedparser/trunk/src/java/org/apache/commons/feedparser/FeedVersion.java (original)
+++ jakarta/commons/sandbox/feedparser/trunk/src/java/org/apache/commons/feedparser/FeedVersion.java Sun Jan 30 15:04:42 2005
@@ -35,6 +35,9 @@
      */
     public boolean isRSS;
     
+    /**
+     * True when this is a Friend of a Friend FOAF file.
+     */
     public boolean isFOAF;
 
     public boolean isOPML;

Modified: jakarta/commons/sandbox/feedparser/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/feedparser/trunk/xdocs/index.xml?view=diff&r1=149180&r2=149181
==============================================================================
--- jakarta/commons/sandbox/feedparser/trunk/xdocs/index.xml (original)
+++ jakarta/commons/sandbox/feedparser/trunk/xdocs/index.xml Sun Jan 30 15:04:42 2005
@@ -94,6 +94,8 @@
 
             <dl>
 
+                <!-- FIXME: provide links to these specifications -->
+
                 <dt>RSS 1.0</dt>
 
                 <dt>RSS 0.9</dt>
@@ -158,8 +160,9 @@
                     FeedParserListener 
                 </a>
 
-                whichreceives callbacks from the FeedParser.  They then pass the
-                FeedParser an InputStream and they are ready to get events:
+                which then receives callbacks from the FeedParser which knows
+                about specific XML formats.  They then pass the FeedParser an
+                InputStream and they are ready to get events:
             </p>
 
             <source>
@@ -260,9 +263,39 @@
 
         </section>
 
+        <section name="Network IO">
+
+            <p>
+                The FeedParser also includes an advanced networking layer which
+                meets the requirements necessary for providing XML aggregations
+                services over HTTP.  This includes support for If-None-Match
+                (ETags), If-Modified-Since (HTTP 304 Not Modified), gzip content
+                encoding (compression), User Agent modification, non-infinite
+                timeouts, event callbacks for download progress, support for
+                setting HTTP Referrer headers, maximum content downloads (no
+                files larger than N bytes), ability to use custom HTTP methods
+                (HEAD, GET, PUT, POST) etc.
+            </p>
+
+            <p>
+                While various APIs already exist for providing HTTP support
+                (java.net.URL and HttpClient) we're using a version of
+                java.net.URL that meets all our requirements and is very
+                reliable. 
+            </p>
+
+            <p>
+                Future plans are to migrate to an HTTP implementation (probably
+                HttpClient) which supports NIO based async event IO.  This
+                library still needs to be developed but in event IO needs to be
+                used to provide a scalable system.
+            </p>
+
+        </section>
+
         <section name="Developers">
 
-            <dt>Kevin Burton</dt>
+            <dt>Kevin A. Burton</dt>
             <dd>Developer and Project Lead</dd>
 
             <dt>Brad Neuberg</dt>



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org