You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2020/01/18 17:04:38 UTC
svn commit: r37670 [30/45] - in /dev/commons/csv/1.8-RC1: ./ binaries/ site/
site/apidocs/ site/apidocs/org/ site/apidocs/org/apache/
site/apidocs/org/apache/commons/ site/apidocs/org/apache/commons/csv/
site/apidocs/org/apache/commons/csv/class-use/ s...
Added: dev/commons/csv/1.8-RC1/site/taglist.html
==============================================================================
--- dev/commons/csv/1.8-RC1/site/taglist.html (added)
+++ dev/commons/csv/1.8-RC1/site/taglist.html Sat Jan 18 17:04:37 2020
@@ -0,0 +1,421 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 18 January 2020
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20200118" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Commons CSV – Tag List report</title>
+
+ <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" />
+ <link rel="stylesheet" href="./css/site.css" type="text/css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+ <script type="text/javascript" src="./js/jquery.min.js"></script>
+ <script type="text/javascript" src="./js/bootstrap.min.js"></script>
+ <script type="text/javascript" src="./js/prettify.min.js"></script>
+ <script type="text/javascript" src="./js/site.js"></script>
+
+
+ </head>
+
+ <body class="composite">
+ <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
+ <img class="logo-left" src=" ./images/commons-logo.png
+" alt="Apache Commons logo"/>
+ </a>
+ <a href="index.html" id="bannerRight" title="Commons CSV™ logo">
+ <img class="logo-right" src=" images/logo.png
+" alt="Commons CSV™ logo"/>
+ </a>
+ <div class="clear"></div>
+
+ <div class="navbar">
+ <div class="navbar-inner">
+ <div class="container-fluid">
+ <a class="brand" href="https://commons.apache.org/proper/commons-csv/">Apache Commons CSV ™</a>
+ <ul class="nav">
+
+ <li id="publishDate">Last Published: 18 January 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 1.8</li>
+ </ul>
+ <div class="pull-right"> <ul class="nav">
+ <li>
+ <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">
+ ApacheCon</a>
+ </li>
+ <li>
+ <a href="http://www.apache.org" class="externalLink" title="Apache">
+ Apache</a>
+ </li>
+ <li>
+ <a href="../../" title="Commons">
+ Commons</a>
+ </li>
+ </ul>
+</div>
+ </div>
+ </div>
+ </div>
+
+ <div class="container-fluid">
+ <table class="layout-table">
+ <tr>
+ <td class="sidebar">
+ <div class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">Commons CSV</li>
+ <li class="none">
+ <a href="index.html" title="Overview">
+ Overview</a>
+ </li>
+ <li class="none">
+ <a href="download_csv.cgi" title="Download">
+ Download</a>
+ </li>
+ <li class="none">
+ <a href="user-guide.html" title="User Guide">
+ User Guide</a>
+ </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/commons/CSV" class="externalLink" title="Wiki">
+ Wiki</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header"><i class="icon-cog"></i>Development</li>
+ <li class="none">
+ <a href="changes-report.html" title="History">
+ History</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">
+ Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html" title="Issue Tracking">
+ Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="team.html" title="Team">
+ Team</a>
+ </li>
+ <li class="none">
+ <a href="apidocs/index.html" title="Javadoc">
+ Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.8" class="externalLink" title="Javadoc 1.8">
+ Javadoc 1.8</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.7" class="externalLink" title="Javadoc 1.7">
+ Javadoc 1.7</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.6" class="externalLink" title="Javadoc 1.6">
+ Javadoc 1.6</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.5" class="externalLink" title="Javadoc 1.5">
+ Javadoc 1.5</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.4" class="externalLink" title="Javadoc 1.4">
+ Javadoc 1.4</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.3" class="externalLink" title="Javadoc 1.3">
+ Javadoc 1.3</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.2" class="externalLink" title="Javadoc 1.2">
+ Javadoc 1.2</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.1" class="externalLink" title="Javadoc 1.1">
+ Javadoc 1.1</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.0" class="externalLink" title="Javadoc 1.0">
+ Javadoc 1.0</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li>
+ <li class="collapsed">
+ <a href="project-info.html" title="Project Information">
+ Project Information</a>
+ </li>
+ <li class="expanded">
+ <a href="project-reports.html" title="Project Reports">
+ Project Reports</a>
+ <ul>
+ <li class="none">
+ <a href="changes-report.html" title="Changes">
+ Changes</a>
+ </li>
+ <li class="none">
+ <a href="jira-report.html" title="JIRA Report">
+ JIRA Report</a>
+ </li>
+ <li class="none">
+ <a href="apidocs/index.html" title="Javadoc">
+ Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="xref/index.html" title="Source Xref">
+ Source Xref</a>
+ </li>
+ <li class="none">
+ <a href="xref-test/index.html" title="Test Source Xref">
+ Test Source Xref</a>
+ </li>
+ <li class="none">
+ <a href="surefire-report.html" title="Surefire Report">
+ Surefire Report</a>
+ </li>
+ <li class="none">
+ <a href="rat-report.html" title="Rat Report">
+ Rat Report</a>
+ </li>
+ <li class="none">
+ <a href="jdepend-report.html" title="JDepend">
+ JDepend</a>
+ </li>
+ <li class="none">
+ <a href="jacoco/index.html" title="JaCoCo">
+ JaCoCo</a>
+ </li>
+ <li class="none">
+ <a href="japicmp.html" title="japicmp">
+ japicmp</a>
+ </li>
+ <li class="none">
+ <a href="checkstyle.html" title="Checkstyle">
+ Checkstyle</a>
+ </li>
+ <li class="none">
+ <a href="cpd.html" title="CPD">
+ CPD</a>
+ </li>
+ <li class="none">
+ <a href="pmd.html" title="PMD">
+ PMD</a>
+ </li>
+ <li class="none">
+ <a href="findbugs.html" title="FindBugs">
+ FindBugs</a>
+ </li>
+ <li class="none active">
+ <a href="taglist.html" title="Tag List">
+ Tag List</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">Commons</li>
+ <li class="none">
+ <a href="../../" title="Home">
+ Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink" title="License">
+ License</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../components.html" title="Components">
+ Components</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../sandbox/index.html" title="Sandbox">
+ Sandbox</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../dormant/index.html" title="Dormant">
+ Dormant</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">General Information</li>
+ <li class="none">
+ <a href="../../security.html" title="Security">
+ Security</a>
+ </li>
+ <li class="none">
+ <a href="../../volunteering.html" title="Volunteering">
+ Volunteering</a>
+ </li>
+ <li class="none">
+ <a href="../../patches.html" title="Contributing Patches">
+ Contributing Patches</a>
+ </li>
+ <li class="none">
+ <a href="../../building.html" title="Building Components">
+ Building Components</a>
+ </li>
+ <li class="none">
+ <a href="../../commons-parent-pom.html" title="Commons Parent Pom">
+ Commons Parent Pom</a>
+ </li>
+ <li class="none">
+ <a href="../../build-plugin/index.html" title="Commons Build Plugin">
+ Commons Build Plugin</a>
+ </li>
+ <li class="none">
+ <a href="../../releases/index.html" title="Releasing Components">
+ Releasing Components</a>
+ </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="Wiki">
+ Wiki</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">ASF</li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+ How the ASF works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+ Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+ Developer Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct">
+ Code of Conduct</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+ Sponsorship</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+ Thanks</a>
+ </li>
+ </ul>
+ </div>
+ <div id="poweredBy">
+ <a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy">
+ <img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" />
+ </a>
+ <a href="http://maven.apache.org/" title="Maven" class="builtBy">
+ <img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </td>
+ <td class="content">
+ <section>
+<h2><a name="Tag_List_Report"></a>Tag List Report</h2>
+<p>The following document contains the listing of user tags found in the code. Below is the summary of the occurrences per tag.</p>
+<table border="0" class="bodyTable">
+<tr class="a">
+<th>Tag Class</th>
+<th>Total number of occurrences</th>
+<th>Tag strings used by tag class</th></tr>
+<tr class="b">
+<td><a href="#tag_class_1">Needs Work</a></td>
+<td>16</td>
+<td>TODO, FIXME, XXX</td></tr>
+<tr class="a">
+<td>Notable Markers</td>
+<td>0</td>
+<td>NOTE, NOPMD, NOSONAR</td></tr></table>
+<p>Each tag is detailed below:</p><section>
+<h3><a name="Needs_Work"></a><a name="tag_class_1">Needs Work</a></h3>
+<p><b>Number of occurrences found in the code: 16</b></p>
+<table border="0" class="bodyTable">
+<tr class="b">
+<th>org.apache.commons.csv.Assertions</th>
+<th>Line</th></tr>
+<tr class="a">
+<td>Replace usage with {@link Objects} when we switch to Java 7.</td>
+<td><a href="./xref/org/apache/commons/csv/Assertions.html#25">25</a></td></tr>
+<tr class="b">
+<th>org.apache.commons.csv.CSVFormat</th>
+<th>Line</th></tr>
+<tr class="a">
+<td>--No comment--</td>
+<td><a href="./xref/org/apache/commons/csv/CSVFormat.html#755">755</a></td></tr>
+<tr class="b">
+<td>--No comment--</td>
+<td><a href="./xref/org/apache/commons/csv/CSVFormat.html#757">757</a></td></tr>
+<tr class="a">
+<td>--No comment--</td>
+<td><a href="./xref/org/apache/commons/csv/CSVFormat.html#759">759</a></td></tr>
+<tr class="b">
+<td>--No comment--</td>
+<td><a href="./xref/org/apache/commons/csv/CSVFormat.html#761">761</a></td></tr>
+<tr class="a">
+<td>--No comment--</td>
+<td><a href="./xref/org/apache/commons/csv/CSVFormat.html#763">763</a></td></tr>
+<tr class="b">
+<th>org.apache.commons.csv.CSVParserTest</th>
+<th>Line</th></tr>
+<tr class="a">
+<td>this may lead to strange behavior, throw an exception if iterator() has already been called?</td>
+<td><a href="./xref-test/org/apache/commons/csv/CSVParserTest.html#896">896</a></td></tr>
+<tr class="b">
+<th>org.apache.commons.csv.CSVPrinter</th>
+<th>Line</th></tr>
+<tr class="a">
+<td>Is it a good idea to do this here instead of on the first call to a print method? It seems a pain to have to track whether the header has already been printed or not.</td>
+<td><a href="./xref/org/apache/commons/csv/CSVPrinter.html#100">100</a></td></tr>
+<tr class="b">
+<th>org.apache.commons.csv.CSVRecord</th>
+<th>Line</th></tr>
+<tr class="a">
+<td>Maybe make this public?</td>
+<td><a href="./xref/org/apache/commons/csv/CSVRecord.html#270">270</a></td></tr>
+<tr class="b">
+<th>org.apache.commons.csv.Lexer</th>
+<th>Line</th></tr>
+<tr class="a">
+<td>escape handling needs more work</td>
+<td><a href="./xref/org/apache/commons/csv/Lexer.html#319">319</a></td></tr>
+<tr class="b">
+<td>is this correct?</td>
+<td><a href="./xref/org/apache/commons/csv/Lexer.html#347">347</a></td></tr>
+<tr class="a">
+<td>is this correct? Do tabs need to be escaped?</td>
+<td><a href="./xref/org/apache/commons/csv/Lexer.html#348">348</a></td></tr>
+<tr class="b">
+<td>is this correct?</td>
+<td><a href="./xref/org/apache/commons/csv/Lexer.html#349">349</a></td></tr>
+<tr class="a">
+<th>org.apache.commons.csv.LexerTest</th>
+<th>Line</th></tr>
+<tr class="b">
+<td>is this correct? Do we expect <esc>TAB to be unescaped?</td>
+<td><a href="./xref-test/org/apache/commons/csv/LexerTest.html#312">312</a></td></tr>
+<tr class="a">
+<td>is this correct? Do we expect <esc>BACKSPACE to be unescaped?</td>
+<td><a href="./xref-test/org/apache/commons/csv/LexerTest.html#327">327</a></td></tr>
+<tr class="b">
+<td>is this correct? Do we expect <esc>FF to be unescaped?</td>
+<td><a href="./xref-test/org/apache/commons/csv/LexerTest.html#341">341</a></td></tr></table></section></section>
+ </td>
+ </tr>
+ </table>
+ </div>
+
+ <div class="footer">
+ <p>Copyright © 2020
+ <a href="https://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.</p>
+
+<div class="center">Apache Commons, Apache Commons CSV, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ </div>
+ </body>
+
+</html>
Added: dev/commons/csv/1.8-RC1/site/team.html
==============================================================================
--- dev/commons/csv/1.8-RC1/site/team.html (added)
+++ dev/commons/csv/1.8-RC1/site/team.html Sat Jan 18 17:04:37 2020
@@ -0,0 +1,386 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 18 January 2020
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20200118" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Commons CSV – Project Team</title>
+
+ <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" />
+ <link rel="stylesheet" href="./css/site.css" type="text/css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+ <script type="text/javascript" src="./js/jquery.min.js"></script>
+ <script type="text/javascript" src="./js/bootstrap.min.js"></script>
+ <script type="text/javascript" src="./js/prettify.min.js"></script>
+ <script type="text/javascript" src="./js/site.js"></script>
+
+
+ </head>
+
+ <body class="composite">
+ <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
+ <img class="logo-left" src=" ./images/commons-logo.png
+" alt="Apache Commons logo"/>
+ </a>
+ <a href="index.html" id="bannerRight" title="Commons CSV™ logo">
+ <img class="logo-right" src=" images/logo.png
+" alt="Commons CSV™ logo"/>
+ </a>
+ <div class="clear"></div>
+
+ <div class="navbar">
+ <div class="navbar-inner">
+ <div class="container-fluid">
+ <a class="brand" href="https://commons.apache.org/proper/commons-csv/">Apache Commons CSV ™</a>
+ <ul class="nav">
+
+ <li id="publishDate">Last Published: 18 January 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 1.8</li>
+ </ul>
+ <div class="pull-right"> <ul class="nav">
+ <li>
+ <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">
+ ApacheCon</a>
+ </li>
+ <li>
+ <a href="http://www.apache.org" class="externalLink" title="Apache">
+ Apache</a>
+ </li>
+ <li>
+ <a href="../../" title="Commons">
+ Commons</a>
+ </li>
+ </ul>
+</div>
+ </div>
+ </div>
+ </div>
+
+ <div class="container-fluid">
+ <table class="layout-table">
+ <tr>
+ <td class="sidebar">
+ <div class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">Commons CSV</li>
+ <li class="none">
+ <a href="index.html" title="Overview">
+ Overview</a>
+ </li>
+ <li class="none">
+ <a href="download_csv.cgi" title="Download">
+ Download</a>
+ </li>
+ <li class="none">
+ <a href="user-guide.html" title="User Guide">
+ User Guide</a>
+ </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/commons/CSV" class="externalLink" title="Wiki">
+ Wiki</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header"><i class="icon-cog"></i>Development</li>
+ <li class="none">
+ <a href="changes-report.html" title="History">
+ History</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">
+ Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html" title="Issue Tracking">
+ Issue Tracking</a>
+ </li>
+ <li class="none active">
+ <a href="team.html" title="Team">
+ Team</a>
+ </li>
+ <li class="none">
+ <a href="apidocs/index.html" title="Javadoc">
+ Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.8" class="externalLink" title="Javadoc 1.8">
+ Javadoc 1.8</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.7" class="externalLink" title="Javadoc 1.7">
+ Javadoc 1.7</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.6" class="externalLink" title="Javadoc 1.6">
+ Javadoc 1.6</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.5" class="externalLink" title="Javadoc 1.5">
+ Javadoc 1.5</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.4" class="externalLink" title="Javadoc 1.4">
+ Javadoc 1.4</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.3" class="externalLink" title="Javadoc 1.3">
+ Javadoc 1.3</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.2" class="externalLink" title="Javadoc 1.2">
+ Javadoc 1.2</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.1" class="externalLink" title="Javadoc 1.1">
+ Javadoc 1.1</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.0" class="externalLink" title="Javadoc 1.0">
+ Javadoc 1.0</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li>
+ <li class="expanded">
+ <a href="project-info.html" title="Project Information">
+ Project Information</a>
+ <ul>
+ <li class="none">
+ <a href="index.html" title="About">
+ About</a>
+ </li>
+ <li class="none">
+ <a href="summary.html" title="Summary">
+ Summary</a>
+ </li>
+ <li class="none active">
+ <a href="team.html" title="Team">
+ Team</a>
+ </li>
+ <li class="none">
+ <a href="scm.html" title="Source Code Management">
+ Source Code Management</a>
+ </li>
+ <li class="none">
+ <a href="issue-management.html" title="Issue Management">
+ Issue Management</a>
+ </li>
+ <li class="none">
+ <a href="mailing-lists.html" title="Mailing Lists">
+ Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="dependency-info.html" title="Dependency Information">
+ Dependency Information</a>
+ </li>
+ <li class="none">
+ <a href="dependencies.html" title="Dependencies">
+ Dependencies</a>
+ </li>
+ <li class="none">
+ <a href="dependency-convergence.html" title="Dependency Convergence">
+ Dependency Convergence</a>
+ </li>
+ <li class="none">
+ <a href="ci-management.html" title="CI Management">
+ CI Management</a>
+ </li>
+ <li class="none">
+ <a href="distribution-management.html" title="Distribution Management">
+ Distribution Management</a>
+ </li>
+ </ul>
+ </li>
+ <li class="collapsed">
+ <a href="project-reports.html" title="Project Reports">
+ Project Reports</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">Commons</li>
+ <li class="none">
+ <a href="../../" title="Home">
+ Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink" title="License">
+ License</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../components.html" title="Components">
+ Components</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../sandbox/index.html" title="Sandbox">
+ Sandbox</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../dormant/index.html" title="Dormant">
+ Dormant</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">General Information</li>
+ <li class="none">
+ <a href="../../security.html" title="Security">
+ Security</a>
+ </li>
+ <li class="none">
+ <a href="../../volunteering.html" title="Volunteering">
+ Volunteering</a>
+ </li>
+ <li class="none">
+ <a href="../../patches.html" title="Contributing Patches">
+ Contributing Patches</a>
+ </li>
+ <li class="none">
+ <a href="../../building.html" title="Building Components">
+ Building Components</a>
+ </li>
+ <li class="none">
+ <a href="../../commons-parent-pom.html" title="Commons Parent Pom">
+ Commons Parent Pom</a>
+ </li>
+ <li class="none">
+ <a href="../../build-plugin/index.html" title="Commons Build Plugin">
+ Commons Build Plugin</a>
+ </li>
+ <li class="none">
+ <a href="../../releases/index.html" title="Releasing Components">
+ Releasing Components</a>
+ </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="Wiki">
+ Wiki</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">ASF</li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+ How the ASF works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+ Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+ Developer Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct">
+ Code of Conduct</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+ Sponsorship</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+ Thanks</a>
+ </li>
+ </ul>
+ </div>
+ <div id="poweredBy">
+ <a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy">
+ <img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" />
+ </a>
+ <a href="http://maven.apache.org/" title="Maven" class="builtBy">
+ <img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </td>
+ <td class="content">
+ <section>
+<h2><a name="Project_Team"></a>Project Team</h2><a name="Project_Team"></a>
+<p>A successful project requires many people to play many roles. Some members write code or documentation, while others are valuable as testers, submitting patches and suggestions.</p>
+<p>The project team is comprised of Members and Contributors. Members have direct access to the source of a project and actively evolve the code-base. Contributors improve the project through submission of patches and suggestions to the Members. The number of Contributors to the project is unbounded. Get involved today. All contributions to the project are greatly appreciated.</p><section>
+<h3><a name="Members"></a>Members</h3><a name="Members"></a>
+<p>The following is a list of developers with commit privileges that have directly contributed to the project in one way or another.</p>
+<table border="0" class="bodyTable">
+<tr class="a">
+<th>Image</th>
+<th>Id</th>
+<th>Name</th>
+<th>Email</th>
+<th>URL</th>
+<th>Organization</th></tr>
+<tr class="b">
+<td><figure><img src="https://www.gravatar.com/avatar/4156866f23b66d5ca7df5cdc86cb9a0e?d=mm&s=60" alt="" /></figure></td>
+<td><a name="bayard"></a>bayard</td>
+<td>Henri Yandell</td>
+<td><a href="bayard@apache.org">bayard@apache.org</a></td>
+<td>-</td>
+<td>The Apache Software Foundation</td></tr>
+<tr class="a">
+<td><figure><img src="https://www.gravatar.com/avatar/77e72680b92db81abf2e41e9c5ed3525?d=mm&s=60" alt="" /></figure></td>
+<td><a name="mvdb"></a>mvdb</td>
+<td>Martin van den Bemt</td>
+<td><a href="mvdb@apache.org">mvdb@apache.org</a></td>
+<td>-</td>
+<td>The Apache Software Foundation</td></tr>
+<tr class="b">
+<td><figure><img src="https://www.gravatar.com/avatar/c142081bd84e031f1951dc8fa42745f2?d=mm&s=60" alt="" /></figure></td>
+<td><a name="yonik"></a>yonik</td>
+<td>Yonik Seeley</td>
+<td><a href="yonik@apache.org">yonik@apache.org</a></td>
+<td>-</td>
+<td>The Apache Software Foundation</td></tr>
+<tr class="a">
+<td><figure><img src="https://www.gravatar.com/avatar/8304c64641badd4218a89a5f97d2ae86?d=mm&s=60" alt="" /></figure></td>
+<td><a name="ebourg"></a>ebourg</td>
+<td>Emmanuel Bourg</td>
+<td><a href="ebourg@apache.org">ebourg@apache.org</a></td>
+<td>-</td>
+<td>Apache</td></tr>
+<tr class="b">
+<td><figure><img src="https://www.gravatar.com/avatar/ebb1af3a9dd9a3dd5f169d9c698f9f21?d=mm&s=60" alt="" /></figure></td>
+<td><a name="ggregory"></a>ggregory</td>
+<td>Gary Gregory</td>
+<td><a href="ggregory@apache.org">ggregory@apache.org</a></td>
+<td><a class="externalLink" href="http://www.garygregory.com">http://www.garygregory.com</a></td>
+<td>-</td></tr>
+<tr class="a">
+<td><figure><img src="https://www.gravatar.com/avatar/cbfb61ee7f8641b2b6eaf22fed163b1e?d=mm&s=60" alt="" /></figure></td>
+<td><a name="britter"></a>britter</td>
+<td>Benedikt Ritter</td>
+<td><a href="britter@apache.org">britter@apache.org</a></td>
+<td>-</td>
+<td>The Apache Software Foundation</td></tr>
+<tr class="b">
+<td><figure><img src="https://www.gravatar.com/avatar/a010ac0916b6b9b10883e9359cfcd7f9?d=mm&s=60" alt="" /></figure></td>
+<td><a name="chtompki"></a>chtompki</td>
+<td>Rob Tompkins</td>
+<td><a href="chtompki@apache.org">chtompki@apache.org</a></td>
+<td>-</td>
+<td>The Apache Software Foundation</td></tr></table></section><section>
+<h3><a name="Contributors"></a>Contributors</h3><a name="Contributors"></a>
+<p>The following additional people have contributed to this project through the way of suggestions, patches or documentation.</p>
+<table border="0" class="bodyTable">
+<tr class="a">
+<th>Name</th></tr>
+<tr class="b">
+<td>Bob Smith</td></tr></table></section></section>
+ </td>
+ </tr>
+ </table>
+ </div>
+
+ <div class="footer">
+ <p>Copyright © 2020
+ <a href="https://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.</p>
+
+<div class="center">Apache Commons, Apache Commons CSV, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ </div>
+ </body>
+
+</html>
Added: dev/commons/csv/1.8-RC1/site/user-guide.html
==============================================================================
--- dev/commons/csv/1.8-RC1/site/user-guide.html (added)
+++ dev/commons/csv/1.8-RC1/site/user-guide.html Sat Jan 18 17:04:37 2020
@@ -0,0 +1,497 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 18 January 2020
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="author" content="Apache Commons Documentation Team" />
+ <meta name="Date-Revision-yyyymmdd" content="20200118" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Commons CSV – User Guide</title>
+
+ <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" />
+ <link rel="stylesheet" href="./css/site.css" type="text/css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+ <script type="text/javascript" src="./js/jquery.min.js"></script>
+ <script type="text/javascript" src="./js/bootstrap.min.js"></script>
+ <script type="text/javascript" src="./js/prettify.min.js"></script>
+ <script type="text/javascript" src="./js/site.js"></script>
+
+
+ </head>
+
+ <body class="composite">
+ <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
+ <img class="logo-left" src=" ./images/commons-logo.png
+" alt="Apache Commons logo"/>
+ </a>
+ <a href="index.html" id="bannerRight" title="Commons CSV™ logo">
+ <img class="logo-right" src=" images/logo.png
+" alt="Commons CSV™ logo"/>
+ </a>
+ <div class="clear"></div>
+
+ <div class="navbar">
+ <div class="navbar-inner">
+ <div class="container-fluid">
+ <a class="brand" href="https://commons.apache.org/proper/commons-csv/">Apache Commons CSV ™</a>
+ <ul class="nav">
+
+ <li id="publishDate">Last Published: 18 January 2020</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 1.8</li>
+ </ul>
+ <div class="pull-right"> <ul class="nav">
+ <li>
+ <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">
+ ApacheCon</a>
+ </li>
+ <li>
+ <a href="http://www.apache.org" class="externalLink" title="Apache">
+ Apache</a>
+ </li>
+ <li>
+ <a href="../../" title="Commons">
+ Commons</a>
+ </li>
+ </ul>
+</div>
+ </div>
+ </div>
+ </div>
+
+ <div class="container-fluid">
+ <table class="layout-table">
+ <tr>
+ <td class="sidebar">
+ <div class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">Commons CSV</li>
+ <li class="none">
+ <a href="index.html" title="Overview">
+ Overview</a>
+ </li>
+ <li class="none">
+ <a href="download_csv.cgi" title="Download">
+ Download</a>
+ </li>
+ <li class="none active">
+ <a href="user-guide.html" title="User Guide">
+ User Guide</a>
+ </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/commons/CSV" class="externalLink" title="Wiki">
+ Wiki</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header"><i class="icon-cog"></i>Development</li>
+ <li class="none">
+ <a href="changes-report.html" title="History">
+ History</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">
+ Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html" title="Issue Tracking">
+ Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="team.html" title="Team">
+ Team</a>
+ </li>
+ <li class="none">
+ <a href="apidocs/index.html" title="Javadoc">
+ Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.8" class="externalLink" title="Javadoc 1.8">
+ Javadoc 1.8</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.7" class="externalLink" title="Javadoc 1.7">
+ Javadoc 1.7</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.6" class="externalLink" title="Javadoc 1.6">
+ Javadoc 1.6</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.5" class="externalLink" title="Javadoc 1.5">
+ Javadoc 1.5</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.4" class="externalLink" title="Javadoc 1.4">
+ Javadoc 1.4</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.3" class="externalLink" title="Javadoc 1.3">
+ Javadoc 1.3</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.2" class="externalLink" title="Javadoc 1.2">
+ Javadoc 1.2</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.1" class="externalLink" title="Javadoc 1.1">
+ Javadoc 1.1</a>
+ </li>
+ <li class="none">
+ <a href="https://javadoc.io/doc/org.apache.commons/commons-csv/1.0" class="externalLink" title="Javadoc 1.0">
+ Javadoc 1.0</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li>
+ <li class="collapsed">
+ <a href="project-info.html" title="Project Information">
+ Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="project-reports.html" title="Project Reports">
+ Project Reports</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">Commons</li>
+ <li class="none">
+ <a href="../../" title="Home">
+ Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink" title="License">
+ License</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../components.html" title="Components">
+ Components</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../sandbox/index.html" title="Sandbox">
+ Sandbox</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../dormant/index.html" title="Dormant">
+ Dormant</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">General Information</li>
+ <li class="none">
+ <a href="../../security.html" title="Security">
+ Security</a>
+ </li>
+ <li class="none">
+ <a href="../../volunteering.html" title="Volunteering">
+ Volunteering</a>
+ </li>
+ <li class="none">
+ <a href="../../patches.html" title="Contributing Patches">
+ Contributing Patches</a>
+ </li>
+ <li class="none">
+ <a href="../../building.html" title="Building Components">
+ Building Components</a>
+ </li>
+ <li class="none">
+ <a href="../../commons-parent-pom.html" title="Commons Parent Pom">
+ Commons Parent Pom</a>
+ </li>
+ <li class="none">
+ <a href="../../build-plugin/index.html" title="Commons Build Plugin">
+ Commons Build Plugin</a>
+ </li>
+ <li class="none">
+ <a href="../../releases/index.html" title="Releasing Components">
+ Releasing Components</a>
+ </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="Wiki">
+ Wiki</a>
+ </li>
+ </ul>
+ <ul class="nav nav-list">
+ <li class="nav-header">ASF</li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+ How the ASF works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+ Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+ Developer Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct">
+ Code of Conduct</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+ Sponsorship</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+ Thanks</a>
+ </li>
+ </ul>
+ </div>
+ <div id="poweredBy">
+ <a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy">
+ <img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" />
+ </a>
+ <a href="http://maven.apache.org/" title="Maven" class="builtBy">
+ <img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </td>
+ <td class="content">
+
+
+
+
+ <h1>Apache Commons CSV User Guide</h1>
+
+
+
+<ul>
+<li><a href="#Parsing_files">Parsing files</a>
+<ul>
+<li><a href="#Example:_Parsing_an_Excel_CSV_File">Example: Parsing an Excel CSV File</a></li>
+<li><a href="#Handling_Byte_Order_Marks">Handling Byte Order Marks</a></li></ul></li>
+<li><a href="#Working_with_headers">Working with headers</a>
+<ul>
+<li><a href="#Accessing_column_values_by_index">Accessing column values by index</a></li>
+<li><a href="#Defining_a_header_manually">Defining a header manually</a></li>
+<li><a href="#Using_an_enum_to_define_a_header">Using an enum to define a header</a></li>
+<li><a href="#Header_auto_detection">Header auto detection</a></li>
+<li><a href="#Printing_with_headers">Printing with headers</a></li></ul></li></ul>
+
+ <section>
+<h2><a name="Parsing_files"></a>Parsing files</h2>
+
+ Parsing files with Apache Commons CSV is relatively straight forward.
+ The CSVFormat class provides some commonly used CSV variants:
+
+
+<dl>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#DEFAULT">DEFAULT</a></dt>
+<dd>Standard Comma Separated Value format, as for RFC4180 but allowing empty lines.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#EXCEL">EXCEL</a></dt>
+<dd>The Microsoft Excel CSV format.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#INFORMIX_UNLOAD">INFORMIX_UNLOAD<sup>1.3</sup></a></dt>
+<dd>Informix <a class="externalLink" href="http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm">UNLOAD</a> format used by the UNLOAD TO file_name operation.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#INFORMIX_UNLOAD_CSV">INFORMIX_UNLOAD_CSV<sup>1.3</sup></a></dt>
+<dd>Informix <a class="externalLink" href="http://www.ibm.com/support/knowledgecenter/SSBJG3_2.5.0/com.ibm.gen_busug.doc/c_fgl_InOutSql_UNLOAD.htm">CSV UNLOAD</a> format used by the UNLOAD TO file_name operation (escaping is disabled.)</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL">MONGO_CSV<sup>1.7</sup></a></dt>
+<dd>MongoDB CSV format used by the mongoexport operation.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL">MONGO_TSV<sup>1.7</sup></a></dt>
+<dd>MongoDB TSV format used by the mongoexport operation.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#MYSQL">MYSQL</a></dt>
+<dd>The MySQL CSV format.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#ORACLE">ORACLE<sup>1.6</sup></a></dt>
+<dd>Default Oracle format used by the SQL*Loader utility.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#POSTGRESSQL_CSV">POSTGRESSQL_CSV<sup>1.5</sup></a></dt>
+<dd>Default PostgreSQL CSV format used by the COPY operation.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#POSTGRESSQL_TEXT">POSTGRESSQL_TEXT<sup>1.5</sup></a></dt>
+<dd>Default PostgreSQL text format used by the COPY operation.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#RFC4180">RFC-4180</a></dt>
+<dd>The RFC-4180 format defined by <a class="externalLink" href="https://tools.ietf.org/html/rfc4180">RFC-4180</a>.</dd>
+
+<dt><a class="externalLink" href="https://commons.apache.org/proper/commons-csv/apidocs/org/apache/commons/csv/CSVFormat.html#TDF">TDF</a></dt>
+<dd>A tab delimited format.</dd>
+ </dl>
+
+ <section>
+<h3><a name="Example:_Parsing_an_Excel_CSV_File"></a>Example: Parsing an Excel CSV File</h3>
+
+<p>To parse an Excel CSV file, write:</p>
+
+<div class="source">
+<pre>Reader in = new FileReader("path/to/file.csv");
+Iterable<CSVRecord> records = CSVFormat.EXCEL.parse(in);
+for (CSVRecord record : records) {
+ String lastName = record.get("Last Name");
+ String firstName = record.get("First Name");
+}
+ </pre></div>
+ </section>
+ <section>
+<h3><a name="Handling_Byte_Order_Marks"></a>Handling Byte Order Marks</h3>
+
+<p>
+ To handle files that start with a Byte Order Mark (BOM) like some Excel CSV files, you need an extra step to
+ deal with these optional bytes.
+ You can use the
+ <a class="externalLink" href="https://commons.apache.org/proper/commons-io/apidocs/org/apache/commons/io/input/BOMInputStream.html">
+ BOMInputStream
+ </a>
+ class from
+ <a class="externalLink" href="https://commons.apache.org/proper/commons-io/">Apache Commons IO</a>
+ for example:
+ </p>
+
+<div class="source">
+<pre>final URL url = ...;
+final Reader reader = new InputStreamReader(new BOMInputStream(url.openStream()), "UTF-8");
+final CSVParser parser = new CSVParser(reader, CSVFormat.EXCEL.withHeader());
+try {
+ for (final CSVRecord record : parser) {
+ final String string = record.get("SomeColumn");
+ ...
+ }
+} finally {
+ parser.close();
+ reader.close();
+}
+ </pre></div>
+
+<p>
+ You might find it handy to create something like this:
+ </p>
+
+<div class="source">
+<pre>/**
+* Creates a reader capable of handling BOMs.
+*/
+public InputStreamReader newReader(final InputStream inputStream) {
+ return new InputStreamReader(new BOMInputStream(inputStream), StandardCharsets.UTF_8);
+}
+ </pre></div>
+ </section>
+ </section>
+
+ <section>
+<h2><a name="Working_with_headers"></a>Working with headers</h2>
+
+ Apache Commons CSV provides several ways to access record values.
+ The simplest way is to access values by their index in the record.
+ However, columns in CSV files often have a name, for example: ID, CustomerNo, Birthday, etc.
+ The CSVFormat class provides an API for specifing these <i>header</i> names and CSVRecord on
+ the other hand has methods to access values by their corresponding header name.
+
+ <section>
+<h3><a name="Accessing_column_values_by_index"></a>Accessing column values by index</h3>
+ To access a record value by index, no special configuration of the CSVFormat is necessary:
+
+<div class="source">
+<pre>Reader in = new FileReader("path/to/file.csv");
+Iterable<CSVRecord> records = CSVFormat.RFC4180.parse(in);
+for (CSVRecord record : records) {
+ String columnOne = record.get(0);
+ String columnTwo = record.get(1);
+}
+ </pre></div>
+ </section>
+ <section>
+<h3><a name="Defining_a_header_manually"></a>Defining a header manually</h3>
+ Indices may not be the most intuitive way to access record values. For this reason it is possible to
+ assign names to each column in the file:
+
+<div class="source">
+<pre>Reader in = new FileReader("path/to/file.csv");
+Iterable<CSVRecord> records = CSVFormat.RFC4180.withHeader("ID", "CustomerNo", "Name").parse(in);
+for (CSVRecord record : records) {
+ String id = record.get("ID");
+ String customerNo = record.get("CustomerNo");
+ String name = record.get("Name");
+}
+ </pre></div>
+ Note that column values can still be accessed using their index.
+ </section>
+ <section>
+<h3><a name="Using_an_enum_to_define_a_header"></a>Using an enum to define a header</h3>
+ Using String values all over the code to reference columns can be error prone. For this reason,
+ it is possible to define an enum to specify header names. Note that the enum constant names are
+ used to access column values. This may lead to enums constant names which do not follow the Java
+ coding standard of defining constants in upper case with underscores:
+
+<div class="source">
+<pre>public enum Headers {
+ ID, CustomerNo, Name
+}
+Reader in = new FileReader("path/to/file.csv");
+Iterable<CSVRecord> records = CSVFormat.RFC4180.withHeader(Headers.class).parse(in);
+for (CSVRecord record : records) {
+ String id = record.get(Headers.ID);
+ String customerNo = record.get(Headers.CustomerNo);
+ String name = record.get(Headers.Name);
+}
+ </pre></div>
+ Again it is possible to access values by their index and by using a String (for example "CustomerNo").
+ </section>
+ <section>
+<h3><a name="Header_auto_detection"></a>Header auto detection</h3>
+ Some CSV files define header names in their first record. If configured, Apache Commons CSV can parse
+ the header names from the first record:
+
+<div class="source">
+<pre>Reader in = new FileReader("path/to/file.csv");
+Iterable<CSVRecord> records = CSVFormat.RFC4180.withFirstRecordAsHeader().parse(in);
+for (CSVRecord record : records) {
+ String id = record.get("ID");
+ String customerNo = record.get("CustomerNo");
+ String name = record.get("Name");
+}
+ </pre></div>
+ This will use the values from the first record as header names and skip the first record when iterating.
+ </section>
+ <section>
+<h3><a name="Printing_with_headers"></a>Printing with headers</h3>
+
+<p>
+ To print a CSV file with headers, you specify the headers in the format:
+ </p>
+
+<div class="source">
+<pre>final Appendable out = ...;
+ final CSVPrinter printer = CSVFormat.DEFAULT.withHeader("H1", "H2").print(out)
+ </pre></div>
+
+<p>
+ To print a CSV file with JDBC column labels, you specify the ResultSet in the format:
+ </p>
+
+<div class="source">
+<pre>final ResultSet resultSet = ...;
+ final CSVPrinter printer = CSVFormat.DEFAULT.withHeader(resultSet).print(out)
+ </pre></div>
+ </section>
+ </section>
+
+
+
+ </td>
+ </tr>
+ </table>
+ </div>
+
+ <div class="footer">
+ <p>Copyright © 2020
+ <a href="https://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.</p>
+
+<div class="center">Apache Commons, Apache Commons CSV, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ </div>
+ </body>
+
+</html>
Added: dev/commons/csv/1.8-RC1/site/xref-test/allclasses-frame.html
==============================================================================
--- dev/commons/csv/1.8-RC1/site/xref-test/allclasses-frame.html (added)
+++ dev/commons/csv/1.8-RC1/site/xref-test/allclasses-frame.html Sat Jan 18 17:04:37 2020
@@ -0,0 +1,43 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xml:lang="en" lang="en">
+ <!-- generated by Apache Maven JXR (jdk8) -->
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+ <title>All Classes</title>
+ <link rel="stylesheet" type="text/css" href="stylesheet.css" title="style" />
+ </head>
+ <body>
+ <h1 class="bar">All Classes</h1>
+ <div class="indexContainer">
+ <ul>
+ <li><a href="org/apache/commons/csv/AssertionsTest.html#AssertionsTest" target="classFrame">AssertionsTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVFileParserTest.html#CSVFileParserTest" target="classFrame">CSVFileParserTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVFormatPredefinedTest.html#CSVFormatPredefinedTest" target="classFrame">CSVFormatPredefinedTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVFormatTest.html#CSVFormatTest" target="classFrame">CSVFormatTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVFormatTest.html#CSVFormatTest.EmptyEnum" target="classFrame">CSVFormatTest.EmptyEnum</a></li>
+ <li><a href="org/apache/commons/csv/CSVFormatTest.html#CSVFormatTest.Header" target="classFrame">CSVFormatTest.Header</a></li>
+ <li><a href="org/apache/commons/csv/CSVParserTest.html#CSVParserTest" target="classFrame">CSVParserTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVPrinterTest.html#CSVPrinterTest" target="classFrame">CSVPrinterTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVRecordTest.html#CSVRecordTest" target="classFrame">CSVRecordTest</a></li>
+ <li><a href="org/apache/commons/csv/CSVRecordTest.html#CSVRecordTest.EnumFixture" target="classFrame">CSVRecordTest.EnumFixture</a></li>
+ <li><a href="org/apache/commons/csv/ExtendedBufferedReaderTest.html#ExtendedBufferedReaderTest" target="classFrame">ExtendedBufferedReaderTest</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv164Test.html#JiraCsv164Test" target="classFrame">JiraCsv164Test</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv167Test.html#JiraCsv167Test" target="classFrame">JiraCsv167Test</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv198Test.html#JiraCsv198Test" target="classFrame">JiraCsv198Test</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv203Test.html#JiraCsv203Test" target="classFrame">JiraCsv203Test</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv213Test.html#JiraCsv213Test" target="classFrame">JiraCsv213Test</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv247Test.html#JiraCsv247Test" target="classFrame">JiraCsv247Test</a></li>
+ <li><a href="org/apache/commons/csv/issues/JiraCsv249Test.html#JiraCsv249Test" target="classFrame">JiraCsv249Test</a></li>
+ <li><a href="org/apache/commons/csv/LexerTest.html#LexerTest" target="classFrame">LexerTest</a></li>
+ <li><a href="org/apache/commons/csv/PerformanceTest.html#PerformanceTest" target="classFrame">PerformanceTest</a></li>
+ <li><a href="org/apache/commons/csv/perf/PerformanceTest.html#PerformanceTest" target="classFrame">PerformanceTest</a></li>
+ <li><a href="org/apache/commons/csv/PerformanceTest.html#PerformanceTest.CSVParserFactory" target="classFrame">PerformanceTest.CSVParserFactory</a></li>
+ <li><a href="org/apache/commons/csv/PerformanceTest.html#PerformanceTest.Stats" target="classFrame">PerformanceTest.Stats</a></li>
+ <li><a href="org/apache/commons/csv/TokenMatchers.html#TokenMatchers" target="classFrame">TokenMatchers</a></li>
+ <li><a href="org/apache/commons/csv/TokenMatchersTest.html#TokenMatchersTest" target="classFrame">TokenMatchersTest</a></li>
+ <li><a href="org/apache/commons/csv/Utils.html#Utils" target="classFrame">Utils</a></li>
+ </ul>
+ </div>
+ </body>
+</html>
Added: dev/commons/csv/1.8-RC1/site/xref-test/index.html
==============================================================================
--- dev/commons/csv/1.8-RC1/site/xref-test/index.html (added)
+++ dev/commons/csv/1.8-RC1/site/xref-test/index.html Sat Jan 18 17:04:37 2020
@@ -0,0 +1,75 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
+<html xml:lang="en" lang="en">
+ <!-- this is a JXR report set (jdk8) -->
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+ <title>Apache Commons CSV 1.8 Reference</title>
+ <script type="text/javascript">
+ tmpTargetPage = "" + window.location.search;
+ if (tmpTargetPage != "" && tmpTargetPage != "undefined")
+ tmpTargetPage = tmpTargetPage.substring(1);
+ if (tmpTargetPage.indexOf(":") != -1 || (tmpTargetPage != "" && !validURL(tmpTargetPage)))
+ tmpTargetPage = "undefined";
+ targetPage = tmpTargetPage;
+ function validURL(url) {
+ try {
+ url = decodeURIComponent(url);
+ }
+ catch (error) {
+ return false;
+ }
+ var pos = url.indexOf(".html");
+ if (pos == -1 || pos != url.length - 5)
+ return false;
+ var allowNumber = false;
+ var allowSep = false;
+ var seenDot = false;
+ for (var i = 0; i < url.length - 5; i++) {
+ var ch = url.charAt(i);
+ if ('a' <= ch && ch <= 'z' ||
+ 'A' <= ch && ch <= 'Z' ||
+ ch == '$' ||
+ ch == '_' ||
+ ch.charCodeAt(0) > 127) {
+ allowNumber = true;
+ allowSep = true;
+ } else if ('0' <= ch && ch <= '9'
+ || ch == '-') {
+ if (!allowNumber)
+ return false;
+ } else if (ch == '/' || ch == '.') {
+ if (!allowSep)
+ return false;
+ allowNumber = false;
+ allowSep = false;
+ if (ch == '.')
+ seenDot = true;
+ if (ch == '/' && seenDot)
+ return false;
+ } else {
+ return false;
+ }
+ }
+ return true;
+ }
+ function loadFrames() {
+ if (targetPage != "" && targetPage != "undefined")
+ top.classFrame.location = top.targetPage;
+ }
+ </script>
+ </head>
+ <frameset cols="20%,80%" title="Documentation frame" onload="top.loadFrames()">
+ <frameset rows="30%,70%" title="Left frames" onload="top.loadFrames()">
+ <frame src="overview-frame.html" name="packageListFrame" title="All Packages"/>
+ <frame src="allclasses-frame.html" name="packageFrame" title="All classes and interfaces (except non-static nested types)"/>
+ </frameset>
+ <frame src="overview-summary.html" name="classFrame" title="Package, class and interface descriptions" scrolling="yes"/>
+ <noframes>
+ <h1>Frame Alert</h1>
+ <p>
+ You don't have frames. Go <a href="overview-summary.html">here</a>
+ </p>
+ </noframes>
+ </frameset>
+</html>
Added: dev/commons/csv/1.8-RC1/site/xref-test/org/apache/commons/csv/AssertionsTest.html
==============================================================================
--- dev/commons/csv/1.8-RC1/site/xref-test/org/apache/commons/csv/AssertionsTest.html (added)
+++ dev/commons/csv/1.8-RC1/site/xref-test/org/apache/commons/csv/AssertionsTest.html Sat Jan 18 17:04:37 2020
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head><meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+<title>AssertionsTest xref</title>
+<link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" />
+</head>
+<body>
+<div id="overview"><a href="../../../../../testapidocs/org/apache/commons/csv/AssertionsTest.html">View Javadoc</a></div><pre>
+<a class="jxr_linenumber" name="L1" href="#L1">1</a> <em class="jxr_comment">/*</em>
+<a class="jxr_linenumber" name="L2" href="#L2">2</a> <em class="jxr_comment"> * Licensed to the Apache Software Foundation (ASF) under one or more</em>
+<a class="jxr_linenumber" name="L3" href="#L3">3</a> <em class="jxr_comment"> * contributor license agreements. See the NOTICE file distributed with</em>
+<a class="jxr_linenumber" name="L4" href="#L4">4</a> <em class="jxr_comment"> * this work for additional information regarding copyright ownership.</em>
+<a class="jxr_linenumber" name="L5" href="#L5">5</a> <em class="jxr_comment"> * The ASF licenses this file to You under the Apache License, Version 2.0</em>
+<a class="jxr_linenumber" name="L6" href="#L6">6</a> <em class="jxr_comment"> * (the "License"); you may not use this file except in compliance with</em>
+<a class="jxr_linenumber" name="L7" href="#L7">7</a> <em class="jxr_comment"> * the License. You may obtain a copy of the License at</em>
+<a class="jxr_linenumber" name="L8" href="#L8">8</a> <em class="jxr_comment"> *</em>
+<a class="jxr_linenumber" name="L9" href="#L9">9</a> <em class="jxr_comment"> * <a href="http://www.apache.org/licenses/LICENSE-2.0" target="alexandria_uri">http://www.apache.org/licenses/LICENSE-2.0</a></em>
+<a class="jxr_linenumber" name="L10" href="#L10">10</a> <em class="jxr_comment"> *</em>
+<a class="jxr_linenumber" name="L11" href="#L11">11</a> <em class="jxr_comment"> * Unless required by applicable law or agreed to in writing, software</em>
+<a class="jxr_linenumber" name="L12" href="#L12">12</a> <em class="jxr_comment"> * distributed under the License is distributed on an "AS IS" BASIS,</em>
+<a class="jxr_linenumber" name="L13" href="#L13">13</a> <em class="jxr_comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</em>
+<a class="jxr_linenumber" name="L14" href="#L14">14</a> <em class="jxr_comment"> * See the License for the specific language governing permissions and</em>
+<a class="jxr_linenumber" name="L15" href="#L15">15</a> <em class="jxr_comment"> * limitations under the License.</em>
+<a class="jxr_linenumber" name="L16" href="#L16">16</a> <em class="jxr_comment"> */</em>
+<a class="jxr_linenumber" name="L17" href="#L17">17</a>
+<a class="jxr_linenumber" name="L18" href="#L18">18</a> <strong class="jxr_keyword">package</strong> org.apache.commons.csv;
+<a class="jxr_linenumber" name="L19" href="#L19">19</a>
+<a class="jxr_linenumber" name="L20" href="#L20">20</a> <strong class="jxr_keyword">import</strong> <strong class="jxr_keyword">static</strong> org.junit.jupiter.api.Assertions.assertThrows;
+<a class="jxr_linenumber" name="L21" href="#L21">21</a>
+<a class="jxr_linenumber" name="L22" href="#L22">22</a> <strong class="jxr_keyword">import</strong> org.junit.jupiter.api.Test;
+<a class="jxr_linenumber" name="L23" href="#L23">23</a>
+<a class="jxr_linenumber" name="L24" href="#L24">24</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L25" href="#L25">25</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L26" href="#L26">26</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">class</strong> <a name="AssertionsTest" href="../../../../org/apache/commons/csv/AssertionsTest.html#AssertionsTest">AssertionsTest</a> {
+<a class="jxr_linenumber" name="L27" href="#L27">27</a>
+<a class="jxr_linenumber" name="L28" href="#L28">28</a> @Test
+<a class="jxr_linenumber" name="L29" href="#L29">29</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> testNotNull() {
+<a class="jxr_linenumber" name="L30" href="#L30">30</a> Assertions.notNull(<strong class="jxr_keyword">new</strong> Object(), <span class="jxr_string">"object"</span>);
+<a class="jxr_linenumber" name="L31" href="#L31">31</a> }
+<a class="jxr_linenumber" name="L32" href="#L32">32</a>
+<a class="jxr_linenumber" name="L33" href="#L33">33</a> @Test
+<a class="jxr_linenumber" name="L34" href="#L34">34</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> testNotNullNull() {
+<a class="jxr_linenumber" name="L35" href="#L35">35</a> assertThrows(IllegalArgumentException.<strong class="jxr_keyword">class</strong>, () -> Assertions.notNull(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"object"</span>));
+<a class="jxr_linenumber" name="L36" href="#L36">36</a> }
+<a class="jxr_linenumber" name="L37" href="#L37">37</a> }
+</pre>
+<hr/>
+<div id="footer">Copyright © 2020 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</div>
+</body>
+</html>