Added: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVFormat.java.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVFormat.java.html (added) +++ websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVFormat.java.html Wed Nov 26 15:56:58 2014 @@ -0,0 +1,1181 @@ +<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>CSVFormat.java</title><link rel="stylesheet" href="../.resources/prettify.css" type="text/css"/><script type="text/javascript" src="../.resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CSV</a> > <a href="index.source.html" class="el_package">org.apache.commons.csv</a> > <span class="el_source">CSVFormat.java</span></div><h1>CSVFormat.j ava</h1><pre class="source lang-java linenums">/* + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to You under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.commons.csv; + +import static org.apache.commons.csv.Constants.BACKSLASH; +import static org.apache.commons.csv.Constants.COMMA; +import static org.apache.commons.csv.Constants.CR; +import static org.apache.commons.csv.Constants.CRLF; +import static org.apache.commons.csv.Constants.DOUBLE_QUOTE_CHAR; +import static org.apache.commons.csv.Constants.LF; +import static org.apache.commons.csv.Constants.TAB; + +import java.io.IOException; +import java.io.Reader; +import java.io.Serializable; +import java.io.StringWriter; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.SQLException; +import java.util.Arrays; +import java.util.HashSet; +import java.util.Set; + +/** + * Specifies the format of a CSV file and parses input. + * + * <h2>Using predefined formats</h2> + * + * <p> + * You can use one of the predefined formats: + * </p> + * + * <ul> + * <li>{@link #DEFAULT}</li> + * <li>{@link #EXCEL}</li> + * <li>{@link #MYSQL}</li> + * <li>{@link #RFC4180}</li> + * <li>{@link #TDF}</li> + * </ul> + * + * <p> + * For example: + * </p> + * + * <pre> + * CSVParser parser = CSVFormat.EXCEL.parse(reader); + * </pre> + * + * <p> + * The {@link CSVParser} provides static methods to parse other input types, for example: + * </p> + * + * <pre> + * CSVParser parser = CSVParser.parse(file, StandardCharsets.US_ASCII, CSVFormat.EXCEL); + * </pre> + * + * <h2>Defining formats</h2> + * + * <p> + * You can extend a format by calling the {@code with} methods. For example: + * </p> + * + * <pre> + * CSVFormat.EXCEL.withNullString(&quot;N/A&quot;).withIgnoreSurroundingSpaces(true); + * </pre> + * + * <h2>Defining column names</h2> + * + * <p> + * To define the column names you want to use to access records, write: + * </p> + * + * <pre> + * CSVFormat.EXCEL.withHeader(&quot;Col1&quot;, &quot;Col2&quot;, &quot;Col3&quot;); + * </pre> + * + * <p> + * Calling {@link #withHeader(String...)} let's you use the given names to address values in a {@link CSVRecord}, and + * assumes that your CSV source does not contain a first record that also defines column names. + * + * If it does, then you are overriding this metadata with your names and you should skip the first record by calling + * {@link #withSkipHeaderRecord(boolean)} with {@code true}. + * </p> + * + * <h2>Parsing</h2> + * + * <p> + * You can use a format directly to parse a reader. For example, to parse an Excel file with columns header, write: + * </p> + * + * <pre> + * Reader in = ...; + * CSVFormat.EXCEL.withHeader(&quot;Col1&quot;, &quot;Col2&quot;, &quot;Col3&quot;).parse(in); + * </pre> + * + * <p> + * For other input types, like resources, files, and URLs, use the static methods on {@link CSVParser}. + * </p> + * + * <h2>Referencing columns safely</h2> + * + * <p> + * If your source contains a header record, you can simplify your code and safely reference columns, by using + * {@link #withHeader(String...)} with no arguments: + * </p> + * + * <pre> + * CSVFormat.EXCEL.withHeader(); + * </pre> + * + * <p> + * This causes the parser to read the first record and use its values as column names. + * + * Then, call one of the {@link CSVRecord} get method that takes a String column name argument: + * </p> + * + * <pre> + * String value = record.get(&quot;Col1&quot;); + * </pre> + * + * <p> + * This makes your code impervious to changes in column order in the CSV file. + * </p> + * + * <h2>Notes</h2> + * + * <p> + * This class is immutable. + * </p> + * + * @version $Id$ + */ +public final class CSVFormat implements Serializable { + + private static final long serialVersionUID = 1L; + + private final char delimiter; + private final Character quoteCharacter; // null if quoting is disabled + private final QuoteMode quoteMode; + private final Character commentMarker; // null if commenting is disabled + private final Character escapeCharacter; // null if escaping is disabled + private final boolean ignoreSurroundingSpaces; // Should leading/trailing spaces be ignored around values? + private final boolean allowMissingColumnNames; + private final boolean ignoreEmptyLines; + private final String recordSeparator; // for outputs + private final String nullString; // the string to be used for null values + private final String[] header; // array of header column names + private final String[] headerComments; // array of header comment lines + private final boolean skipHeaderRecord; + + /** + * Standard comma separated format, as for {@link #RFC4180} but allowing empty lines. + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>withDelimiter(',')</li> + * <li>withQuote('"')</li> + * <li>withRecordSeparator("\r\n")</li> + * <li>withIgnoreEmptyLines(true)</li> + * </ul> + */ +<span class="fc" id="L179"> public static final CSVFormat DEFAULT = new CSVFormat(COMMA, DOUBLE_QUOTE_CHAR, null, null, null, false, true,</span> + CRLF, null, null, null, false, false); + + /** + * Comma separated format as defined by <a href="http://tools.ietf.org/html/rfc4180">RFC 4180</a>. + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>withDelimiter(',')</li> + * <li>withQuote('"')</li> + * <li>withRecordSeparator("\r\n")</li> + * <li>withIgnoreEmptyLines(false)</li> + * </ul> + */ +<span class="fc" id="L195"> public static final CSVFormat RFC4180 = DEFAULT.withIgnoreEmptyLines(false);</span> + + /** + * Excel file format (using a comma as the value delimiter). Note that the actual value delimiter used by Excel is + * locale dependent, it might be necessary to customize this format to accommodate to your regional settings. + * + * <p> + * For example for parsing or generating a CSV file on a French system the following format will be used: + * </p> + * + * <pre> + * CSVFormat fmt = CSVFormat.EXCEL.withDelimiter(';'); + * </pre> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>{@link #withDelimiter(char) withDelimiter(',')}</li> + * <li>{@link #withQuote(char) withQuote('"')}</li> + * <li>{@link #withRecordSeparator(String) withRecordSeparator("\r\n")}</li> + * <li>{@link #withIgnoreEmptyLines(boolean) withIgnoreEmptyLines(false)}</li> + * <li>{@link #withAllowMissingColumnNames(boolean) withAllowMissingColumnNames(true)}</li> + * </ul> + * <p> + * Note: this is currently like {@link #RFC4180} plus {@link #withAllowMissingColumnNames(boolean) + * withAllowMissingColumnNames(true)}. + * </p> + */ +<span class="fc" id="L224"> public static final CSVFormat EXCEL = DEFAULT.withIgnoreEmptyLines(false).withAllowMissingColumnNames();</span> + + /** + * Tab-delimited format. + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>withDelimiter('\t')</li> + * <li>withQuote('"')</li> + * <li>withRecordSeparator("\r\n")</li> + * <li>withIgnoreSurroundingSpaces(true)</li> + * </ul> + */ +<span class="fc" id="L239"> public static final CSVFormat TDF = DEFAULT.withDelimiter(TAB).withIgnoreSurroundingSpaces();</span> + + /** + * Default MySQL format used by the {@code SELECT INTO OUTFILE} and {@code LOAD DATA INFILE} operations. + * + * <p> + * This is a tab-delimited format with a LF character as the line separator. Values are not quoted and special + * characters are escaped with '\'. + * </p> + * + * <p> + * Settings are: + * </p> + * <ul> + * <li>withDelimiter('\t')</li> + * <li>withQuote(null)</li> + * <li>withRecordSeparator('\n')</li> + * <li>withIgnoreEmptyLines(false)</li> + * <li>withEscape('\\')</li> + * </ul> + * + * @see <a href="http://dev.mysql.com/doc/refman/5.1/en/load-data.html"> + * http://dev.mysql.com/doc/refman/5.1/en/load-data.html</a> + */ +<span class="fc" id="L263"> public static final CSVFormat MYSQL = DEFAULT.withDelimiter(TAB).withEscape(BACKSLASH).withIgnoreEmptyLines(false)</span> +<span class="fc" id="L264"> .withQuote(null).withRecordSeparator(LF);</span> + + /** + * Returns true if the given character is a line break character. + * + * @param c + * the character to check + * + * @return true if <code>c</code> is a line break character + */ + private static boolean isLineBreak(final char c) { +<span class="fc bfc" id="L275" title="All 4 branches covered."> return c == LF || c == CR;</span> + } + + /** + * Returns true if the given character is a line break character. + * + * @param c + * the character to check, may be null + * + * @return true if <code>c</code> is a line break character (and not null) + */ + private static boolean isLineBreak(final Character c) { +<span class="fc bfc" id="L287" title="All 4 branches covered."> return c != null && isLineBreak(c.charValue());</span> + } + + /** + * Creates a new CSV format with the specified delimiter. + * + * <p> + * Use this method if you want to create a CSVFormat from scratch. All fields but the delimiter will be initialized + * with null/false. + * </p> + * + * @param delimiter + * the char used for value separation, must not be a line break character + * @return a new CSV format. + * @throws IllegalArgumentException + * if the delimiter is a line break character + * + * @see #DEFAULT + * @see #RFC4180 + * @see #MYSQL + * @see #EXCEL + * @see #TDF + */ + public static CSVFormat newFormat(final char delimiter) { +<span class="fc" id="L311"> return new CSVFormat(delimiter, null, null, null, null, false, false, null, null, null, null, false, false);</span> + } + + /** + * Creates a customized CSV format. + * + * @param delimiter + * the char used for value separation, must not be a line break character + * @param quoteChar + * the Character used as value encapsulation marker, may be {@code null} to disable + * @param quoteMode + * the quote mode + * @param commentStart + * the Character used for comment identification, may be {@code null} to disable + * @param escape + * the Character used to escape special characters in values, may be {@code null} to disable + * @param ignoreSurroundingSpaces + * {@code true} when whitespaces enclosing values should be ignored + * @param ignoreEmptyLines + * {@code true} when the parser should skip empty lines + * @param recordSeparator + * the line separator to use for output + * @param nullString + * the line separator to use for output + * @param headerComments + * the comments to be printed by the Printer before the actual CSV data + * @param header + * the header + * @param skipHeaderRecord + * TODO + * @param allowMissingColumnNames + * TODO + * @throws IllegalArgumentException + * if the delimiter is a line break character + */ + private CSVFormat(final char delimiter, final Character quoteChar, final QuoteMode quoteMode, + final Character commentStart, final Character escape, final boolean ignoreSurroundingSpaces, + final boolean ignoreEmptyLines, final String recordSeparator, final String nullString, + final Object[] headerComments, final String[] header, final boolean skipHeaderRecord, +<span class="fc" id="L350"> final boolean allowMissingColumnNames) {</span> +<span class="fc" id="L351"> this.delimiter = delimiter;</span> +<span class="fc" id="L352"> this.quoteCharacter = quoteChar;</span> +<span class="fc" id="L353"> this.quoteMode = quoteMode;</span> +<span class="fc" id="L354"> this.commentMarker = commentStart;</span> +<span class="fc" id="L355"> this.escapeCharacter = escape;</span> +<span class="fc" id="L356"> this.ignoreSurroundingSpaces = ignoreSurroundingSpaces;</span> +<span class="fc" id="L357"> this.allowMissingColumnNames = allowMissingColumnNames;</span> +<span class="fc" id="L358"> this.ignoreEmptyLines = ignoreEmptyLines;</span> +<span class="fc" id="L359"> this.recordSeparator = recordSeparator;</span> +<span class="fc" id="L360"> this.nullString = nullString;</span> +<span class="fc" id="L361"> this.headerComments = toStringArray(headerComments);</span> +<span class="fc bfc" id="L362" title="All 2 branches covered."> this.header = header == null ? null : header.clone();</span> +<span class="fc" id="L363"> this.skipHeaderRecord = skipHeaderRecord;</span> +<span class="fc" id="L364"> validate();</span> +<span class="fc" id="L365"> }</span> + + private String[] toStringArray(final Object[] values) { +<span class="fc bfc" id="L368" title="All 2 branches covered."> if (values == null) {</span> +<span class="fc" id="L369"> return null;</span> + } +<span class="fc" id="L371"> final String[] strings = new String[values.length];</span> +<span class="fc bfc" id="L372" title="All 2 branches covered."> for (int i = 0; i < values.length; i++) {</span> +<span class="fc" id="L373"> final Object value = values[i];</span> +<span class="pc bpc" id="L374" title="1 of 2 branches missed."> strings[i] = value == null ? null : value.toString();</span> + } +<span class="fc" id="L376"> return strings;</span> + } + + @Override + public boolean equals(final Object obj) { +<span class="fc bfc" id="L381" title="All 2 branches covered."> if (this == obj) {</span> +<span class="fc" id="L382"> return true;</span> + } +<span class="fc bfc" id="L384" title="All 2 branches covered."> if (obj == null) {</span> +<span class="fc" id="L385"> return false;</span> + } +<span class="fc bfc" id="L387" title="All 2 branches covered."> if (getClass() != obj.getClass()) {</span> +<span class="fc" id="L388"> return false;</span> + } + +<span class="fc" id="L391"> final CSVFormat other = (CSVFormat) obj;</span> +<span class="fc bfc" id="L392" title="All 2 branches covered."> if (delimiter != other.delimiter) {</span> +<span class="fc" id="L393"> return false;</span> + } +<span class="fc bfc" id="L395" title="All 2 branches covered."> if (quoteMode != other.quoteMode) {</span> +<span class="fc" id="L396"> return false;</span> + } +<span class="pc bpc" id="L398" title="1 of 2 branches missed."> if (quoteCharacter == null) {</span> +<span class="nc bnc" id="L399" title="All 2 branches missed."> if (other.quoteCharacter != null) {</span> +<span class="nc" id="L400"> return false;</span> + } +<span class="fc bfc" id="L402" title="All 2 branches covered."> } else if (!quoteCharacter.equals(other.quoteCharacter)) {</span> +<span class="fc" id="L403"> return false;</span> + } +<span class="fc bfc" id="L405" title="All 2 branches covered."> if (commentMarker == null) {</span> +<span class="pc bpc" id="L406" title="1 of 2 branches missed."> if (other.commentMarker != null) {</span> +<span class="nc" id="L407"> return false;</span> + } +<span class="fc bfc" id="L409" title="All 2 branches covered."> } else if (!commentMarker.equals(other.commentMarker)) {</span> +<span class="fc" id="L410"> return false;</span> + } +<span class="fc bfc" id="L412" title="All 2 branches covered."> if (escapeCharacter == null) {</span> +<span class="pc bpc" id="L413" title="1 of 2 branches missed."> if (other.escapeCharacter != null) {</span> +<span class="nc" id="L414"> return false;</span> + } +<span class="fc bfc" id="L416" title="All 2 branches covered."> } else if (!escapeCharacter.equals(other.escapeCharacter)) {</span> +<span class="fc" id="L417"> return false;</span> + } +<span class="fc bfc" id="L419" title="All 2 branches covered."> if (nullString == null) {</span> +<span class="pc bpc" id="L420" title="1 of 2 branches missed."> if (other.nullString != null) {</span> +<span class="nc" id="L421"> return false;</span> + } +<span class="fc bfc" id="L423" title="All 2 branches covered."> } else if (!nullString.equals(other.nullString)) {</span> +<span class="fc" id="L424"> return false;</span> + } +<span class="fc bfc" id="L426" title="All 2 branches covered."> if (!Arrays.equals(header, other.header)) {</span> +<span class="fc" id="L427"> return false;</span> + } +<span class="fc bfc" id="L429" title="All 2 branches covered."> if (ignoreSurroundingSpaces != other.ignoreSurroundingSpaces) {</span> +<span class="fc" id="L430"> return false;</span> + } +<span class="fc bfc" id="L432" title="All 2 branches covered."> if (ignoreEmptyLines != other.ignoreEmptyLines) {</span> +<span class="fc" id="L433"> return false;</span> + } +<span class="fc bfc" id="L435" title="All 2 branches covered."> if (skipHeaderRecord != other.skipHeaderRecord) {</span> +<span class="fc" id="L436"> return false;</span> + } +<span class="pc bpc" id="L438" title="1 of 2 branches missed."> if (recordSeparator == null) {</span> +<span class="nc bnc" id="L439" title="All 2 branches missed."> if (other.recordSeparator != null) {</span> +<span class="nc" id="L440"> return false;</span> + } +<span class="fc bfc" id="L442" title="All 2 branches covered."> } else if (!recordSeparator.equals(other.recordSeparator)) {</span> +<span class="fc" id="L443"> return false;</span> + } +<span class="fc" id="L445"> return true;</span> + } + + /** + * Formats the specified values. + * + * @param values + * the values to format + * @return the formatted values + */ + public String format(final Object... values) { +<span class="fc" id="L456"> final StringWriter out = new StringWriter();</span> + try { +<span class="fc" id="L458"> new CSVPrinter(out, this).printRecord(values);</span> +<span class="fc" id="L459"> return out.toString().trim();</span> +<span class="nc" id="L460"> } catch (final IOException e) {</span> + // should not happen because a StringWriter does not do IO. +<span class="nc" id="L462"> throw new IllegalStateException(e);</span> + } + } + + /** + * Returns the character marking the start of a line comment. + * + * @return the comment start marker, may be {@code null} + */ + public Character getCommentMarker() { +<span class="fc" id="L472"> return commentMarker;</span> + } + + /** + * Returns the character delimiting the values (typically ';', ',' or '\t'). + * + * @return the delimiter character + */ + public char getDelimiter() { +<span class="fc" id="L481"> return delimiter;</span> + } + + /** + * Returns the escape character. + * + * @return the escape character, may be {@code null} + */ + public Character getEscapeCharacter() { +<span class="fc" id="L490"> return escapeCharacter;</span> + } + + /** + * Returns a copy of the header array. + * + * @return a copy of the header array; {@code null} if disabled, the empty array if to be read from the file + */ + public String[] getHeader() { +<span class="fc bfc" id="L499" title="All 2 branches covered."> return header != null ? header.clone() : null;</span> + } + + /** + * Returns a copy of the header comment array. + * + * @return a copy of the header comment array; {@code null} if disabled. + */ + public String[] getHeaderComments() { +<span class="fc bfc" id="L508" title="All 2 branches covered."> return headerComments != null ? headerComments.clone() : null;</span> + } + + /** + * Specifies whether missing column names are allowed when parsing the header line. + * + * @return {@code true} if missing column names are allowed when parsing the header line, {@code false} to throw an + * {@link IllegalArgumentException}. + */ + public boolean getAllowMissingColumnNames() { +<span class="fc" id="L518"> return allowMissingColumnNames;</span> + } + + /** + * Specifies whether empty lines between records are ignored when parsing input. + * + * @return {@code true} if empty lines between records are ignored, {@code false} if they are turned into empty + * records. + */ + public boolean getIgnoreEmptyLines() { +<span class="fc" id="L528"> return ignoreEmptyLines;</span> + } + + /** + * Specifies whether spaces around values are ignored when parsing input. + * + * @return {@code true} if spaces around values are ignored, {@code false} if they are treated as part of the value. + */ + public boolean getIgnoreSurroundingSpaces() { +<span class="fc" id="L537"> return ignoreSurroundingSpaces;</span> + } + + /** + * Gets the String to convert to and from {@code null}. + * <ul> + * <li> + * <strong>Reading:</strong> Converts strings equal to the given {@code nullString} to {@code null} when reading + * records.</li> + * <li> + * <strong>Writing:</strong> Writes {@code null} as the given {@code nullString} when writing records.</li> + * </ul> + * + * @return the String to convert to and from {@code null}. No substitution occurs if {@code null} + */ + public String getNullString() { +<span class="fc" id="L553"> return nullString;</span> + } + + /** + * Returns the character used to encapsulate values containing special characters. + * + * @return the quoteChar character, may be {@code null} + */ + public Character getQuoteCharacter() { +<span class="fc" id="L562"> return quoteCharacter;</span> + } + + /** + * Returns the quote policy output fields. + * + * @return the quote policy + */ + public QuoteMode getQuoteMode() { +<span class="fc" id="L571"> return quoteMode;</span> + } + + /** + * Returns the record separator delimiting output records. + * + * @return the record separator + */ + public String getRecordSeparator() { +<span class="fc" id="L580"> return recordSeparator;</span> + } + + /** + * Returns whether to skip the header record. + * + * @return whether to skip the header record. + */ + public boolean getSkipHeaderRecord() { +<span class="fc" id="L589"> return skipHeaderRecord;</span> + } + + @Override + public int hashCode() { +<span class="fc" id="L594"> final int prime = 31;</span> +<span class="fc" id="L595"> int result = 1;</span> + +<span class="fc" id="L597"> result = prime * result + delimiter;</span> +<span class="pc bpc" id="L598" title="1 of 2 branches missed."> result = prime * result + ((quoteMode == null) ? 0 : quoteMode.hashCode());</span> +<span class="pc bpc" id="L599" title="1 of 2 branches missed."> result = prime * result + ((quoteCharacter == null) ? 0 : quoteCharacter.hashCode());</span> +<span class="pc bpc" id="L600" title="1 of 2 branches missed."> result = prime * result + ((commentMarker == null) ? 0 : commentMarker.hashCode());</span> +<span class="pc bpc" id="L601" title="1 of 2 branches missed."> result = prime * result + ((escapeCharacter == null) ? 0 : escapeCharacter.hashCode());</span> +<span class="pc bpc" id="L602" title="1 of 2 branches missed."> result = prime * result + ((nullString == null) ? 0 : nullString.hashCode());</span> +<span class="pc bpc" id="L603" title="1 of 2 branches missed."> result = prime * result + (ignoreSurroundingSpaces ? 1231 : 1237);</span> +<span class="pc bpc" id="L604" title="1 of 2 branches missed."> result = prime * result + (ignoreEmptyLines ? 1231 : 1237);</span> +<span class="pc bpc" id="L605" title="1 of 2 branches missed."> result = prime * result + (skipHeaderRecord ? 1231 : 1237);</span> +<span class="pc bpc" id="L606" title="1 of 2 branches missed."> result = prime * result + ((recordSeparator == null) ? 0 : recordSeparator.hashCode());</span> +<span class="fc" id="L607"> result = prime * result + Arrays.hashCode(header);</span> +<span class="fc" id="L608"> return result;</span> + } + + /** + * Specifies whether comments are supported by this format. + * + * Note that the comment introducer character is only recognized at the start of a line. + * + * @return {@code true} is comments are supported, {@code false} otherwise + */ + public boolean isCommentMarkerSet() { +<span class="fc bfc" id="L619" title="All 2 branches covered."> return commentMarker != null;</span> + } + + /** + * Returns whether escape are being processed. + * + * @return {@code true} if escapes are processed + */ + public boolean isEscapeCharacterSet() { +<span class="fc bfc" id="L628" title="All 2 branches covered."> return escapeCharacter != null;</span> + } + + /** + * Returns whether a nullString has been defined. + * + * @return {@code true} if a nullString is defined + */ + public boolean isNullStringSet() { +<span class="pc bpc" id="L637" title="1 of 2 branches missed."> return nullString != null;</span> + } + + /** + * Returns whether a quoteChar has been defined. + * + * @return {@code true} if a quoteChar is defined + */ + public boolean isQuoteCharacterSet() { +<span class="fc bfc" id="L646" title="All 2 branches covered."> return quoteCharacter != null;</span> + } + + /** + * Parses the specified content. + * + * <p> + * See also the various static parse methods on {@link CSVParser}. + * </p> + * + * @param in + * the input stream + * @return a parser over a stream of {@link CSVRecord}s. + * @throws IOException + * If an I/O error occurs + */ + public CSVParser parse(final Reader in) throws IOException { +<span class="fc" id="L663"> return new CSVParser(in, this);</span> + } + + /** + * Prints to the specified output. + * + * <p> + * See also {@link CSVPrinter}. + * </p> + * + * @param out + * the output + * @return a printer to an output + * @throws IOException + * thrown if the optional header cannot be printed. + */ + public CSVPrinter print(final Appendable out) throws IOException { +<span class="fc" id="L680"> return new CSVPrinter(out, this);</span> + } + + @Override + public String toString() { +<span class="fc" id="L685"> final StringBuilder sb = new StringBuilder();</span> +<span class="fc" id="L686"> sb.append("Delimiter=<").append(delimiter).append('>');</span> +<span class="pc bpc" id="L687" title="1 of 2 branches missed."> if (isEscapeCharacterSet()) {</span> +<span class="nc" id="L688"> sb.append(' ');</span> +<span class="nc" id="L689"> sb.append("Escape=<").append(escapeCharacter).append('>');</span> + } +<span class="pc bpc" id="L691" title="1 of 2 branches missed."> if (isQuoteCharacterSet()) {</span> +<span class="fc" id="L692"> sb.append(' ');</span> +<span class="fc" id="L693"> sb.append("QuoteChar=<").append(quoteCharacter).append('>');</span> + } +<span class="fc bfc" id="L695" title="All 2 branches covered."> if (isCommentMarkerSet()) {</span> +<span class="fc" id="L696"> sb.append(' ');</span> +<span class="fc" id="L697"> sb.append("CommentStart=<").append(commentMarker).append('>');</span> + } +<span class="pc bpc" id="L699" title="1 of 2 branches missed."> if (isNullStringSet()) {</span> +<span class="nc" id="L700"> sb.append(' ');</span> +<span class="nc" id="L701"> sb.append("NullString=<").append(nullString).append('>');</span> + } +<span class="pc bpc" id="L703" title="1 of 2 branches missed."> if (recordSeparator != null) {</span> +<span class="nc" id="L704"> sb.append(' ');</span> +<span class="nc" id="L705"> sb.append("RecordSeparator=<").append(recordSeparator).append('>');</span> + } +<span class="fc bfc" id="L707" title="All 2 branches covered."> if (getIgnoreEmptyLines()) {</span> +<span class="fc" id="L708"> sb.append(" EmptyLines:ignored");</span> + } +<span class="fc bfc" id="L710" title="All 2 branches covered."> if (getIgnoreSurroundingSpaces()) {</span> +<span class="fc" id="L711"> sb.append(" SurroundingSpaces:ignored");</span> + } +<span class="fc" id="L713"> sb.append(" SkipHeaderRecord:").append(skipHeaderRecord);</span> +<span class="pc bpc" id="L714" title="1 of 2 branches missed."> if (headerComments != null) {</span> +<span class="nc" id="L715"> sb.append(' ');</span> +<span class="nc" id="L716"> sb.append("HeaderComments:").append(Arrays.toString(headerComments));</span> + } +<span class="pc bpc" id="L718" title="1 of 2 branches missed."> if (header != null) {</span> +<span class="nc" id="L719"> sb.append(' ');</span> +<span class="nc" id="L720"> sb.append("Header:").append(Arrays.toString(header));</span> + } +<span class="fc" id="L722"> return sb.toString();</span> + } + + /** + * Verifies the consistency of the parameters and throws an IllegalArgumentException if necessary. + * + * @throws IllegalArgumentException + */ + private void validate() throws IllegalArgumentException { +<span class="pc bpc" id="L731" title="1 of 2 branches missed."> if (isLineBreak(delimiter)) {</span> +<span class="nc" id="L732"> throw new IllegalArgumentException("The delimiter cannot be a line break");</span> + } + +<span class="fc bfc" id="L735" title="All 4 branches covered."> if (quoteCharacter != null && delimiter == quoteCharacter.charValue()) {</span> +<span class="fc" id="L736"> throw new IllegalArgumentException("The quoteChar character and the delimiter cannot be the same ('" +</span> + quoteCharacter + "')"); + } + +<span class="fc bfc" id="L740" title="All 4 branches covered."> if (escapeCharacter != null && delimiter == escapeCharacter.charValue()) {</span> +<span class="fc" id="L741"> throw new IllegalArgumentException("The escape character and the delimiter cannot be the same ('" +</span> + escapeCharacter + "')"); + } + +<span class="fc bfc" id="L745" title="All 4 branches covered."> if (commentMarker != null && delimiter == commentMarker.charValue()) {</span> +<span class="fc" id="L746"> throw new IllegalArgumentException("The comment start character and the delimiter cannot be the same ('" +</span> + commentMarker + "')"); + } + +<span class="fc bfc" id="L750" title="All 4 branches covered."> if (quoteCharacter != null && quoteCharacter.equals(commentMarker)) {</span> +<span class="fc" id="L751"> throw new IllegalArgumentException("The comment start character and the quoteChar cannot be the same ('" +</span> + commentMarker + "')"); + } + +<span class="fc bfc" id="L755" title="All 4 branches covered."> if (escapeCharacter != null && escapeCharacter.equals(commentMarker)) {</span> +<span class="fc" id="L756"> throw new IllegalArgumentException("The comment start and the escape character cannot be the same ('" +</span> + commentMarker + "')"); + } + +<span class="fc bfc" id="L760" title="All 4 branches covered."> if (escapeCharacter == null && quoteMode == QuoteMode.NONE) {</span> +<span class="fc" id="L761"> throw new IllegalArgumentException("No quotes mode set but no escape character is set");</span> + } + + // validate header +<span class="fc bfc" id="L765" title="All 2 branches covered."> if (header != null) {</span> +<span class="fc" id="L766"> final Set<String> dupCheck = new HashSet<String>();</span> +<span class="fc bfc" id="L767" title="All 2 branches covered."> for (final String hdr : header) {</span> +<span class="fc bfc" id="L768" title="All 2 branches covered."> if (!dupCheck.add(hdr)) {</span> +<span class="fc" id="L769"> throw new IllegalArgumentException("The header contains a duplicate entry: '" + hdr + "' in " +</span> +<span class="fc" id="L770"> Arrays.toString(header));</span> + } + } + } +<span class="fc" id="L774"> }</span> + + /** + * Sets the comment start marker of the format to the specified character. + * + * Note that the comment start character is only recognized at the start of a line. + * + * @param commentMarker + * the comment start marker + * @return A new CSVFormat that is equal to this one but with the specified character as the comment start marker + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withCommentMarker(final char commentMarker) { +<span class="fc" id="L788"> return withCommentMarker(Character.valueOf(commentMarker));</span> + } + + /** + * Sets the comment start marker of the format to the specified character. + * + * Note that the comment start character is only recognized at the start of a line. + * + * @param commentMarker + * the comment start marker, use {@code null} to disable + * @return A new CSVFormat that is equal to this one but with the specified character as the comment start marker + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withCommentMarker(final Character commentMarker) { +<span class="fc bfc" id="L803" title="All 2 branches covered."> if (isLineBreak(commentMarker)) {</span> +<span class="fc" id="L804"> throw new IllegalArgumentException("The comment start marker character cannot be a line break");</span> + } +<span class="fc" id="L806"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the delimiter of the format to the specified character. + * + * @param delimiter + * the delimiter character + * @return A new CSVFormat that is equal to this with the specified character as delimiter + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withDelimiter(final char delimiter) { +<span class="fc bfc" id="L821" title="All 2 branches covered."> if (isLineBreak(delimiter)) {</span> +<span class="fc" id="L822"> throw new IllegalArgumentException("The delimiter cannot be a line break");</span> + } +<span class="fc" id="L824"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the escape character of the format to the specified character. + * + * @param escape + * the escape character + * @return A new CSVFormat that is equal to his but with the specified character as the escape character + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withEscape(final char escape) { +<span class="fc" id="L839"> return withEscape(Character.valueOf(escape));</span> + } + + /** + * Sets the escape character of the format to the specified character. + * + * @param escape + * the escape character, use {@code null} to disable + * @return A new CSVFormat that is equal to this but with the specified character as the escape character + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withEscape(final Character escape) { +<span class="fc bfc" id="L852" title="All 2 branches covered."> if (isLineBreak(escape)) {</span> +<span class="fc" id="L853"> throw new IllegalArgumentException("The escape character cannot be a line break");</span> + } +<span class="fc" id="L855"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escape, ignoreSurroundingSpaces,</span> + ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, allowMissingColumnNames); + } + + /** + * Sets the header of the format. The header can either be parsed automatically from the input file with: + * + * <pre> + * CSVFormat format = aformat.withHeader(); + * </pre> + * + * or specified manually with: + * + * <pre> + * CSVFormat format = aformat.withHeader(&quot;name&quot;, &quot;email&quot;, &quot;phone&quot;); + * </pre> + * <p> + * The header is also used by the {@link CSVPrinter}.. + * </p> + * + * @param header + * the header, {@code null} if disabled, empty if parsed automatically, user specified otherwise. + * + * @return A new CSVFormat that is equal to this but with the specified header + * @see #withSkipHeaderRecord(boolean) + */ + public CSVFormat withHeader(final String... header) { +<span class="fc" id="L882"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the header of the format. The header can either be parsed automatically from the input file with: + * + * <pre> + * CSVFormat format = aformat.withHeader(); + * </pre> + * + * or specified manually with: + * + * <pre> + * CSVFormat format = aformat.withHeader(resultSet); + * </pre> + * <p> + * The header is also used by the {@link CSVPrinter}.. + * </p> + * + * @param resultSet + * the resultSet for the header, {@code null} if disabled, empty if parsed automatically, user specified + * otherwise. + * + * @return A new CSVFormat that is equal to this but with the specified header + * @throws SQLException + * SQLException if a database access error occurs or this method is called on a closed result set. + * @since 1.1 + */ + public CSVFormat withHeader(final ResultSet resultSet) throws SQLException { +<span class="pc bpc" id="L913" title="1 of 2 branches missed."> return withHeader(resultSet != null ? resultSet.getMetaData() : null);</span> + } + + /** + * Sets the header of the format. The header can either be parsed automatically from the input file with: + * + * <pre> + * CSVFormat format = aformat.withHeader(); + * </pre> + * + * or specified manually with: + * + * <pre> + * CSVFormat format = aformat.withHeader(metaData); + * </pre> + * <p> + * The header is also used by the {@link CSVPrinter}.. + * </p> + * + * @param metaData + * the metaData for the header, {@code null} if disabled, empty if parsed automatically, user specified + * otherwise. + * + * @return A new CSVFormat that is equal to this but with the specified header + * @throws SQLException + * SQLException if a database access error occurs or this method is called on a closed result set. + * @since 1.1 + */ + public CSVFormat withHeader(final ResultSetMetaData metaData) throws SQLException { +<span class="fc" id="L942"> String[] labels = null;</span> +<span class="pc bpc" id="L943" title="1 of 2 branches missed."> if (metaData != null) {</span> +<span class="fc" id="L944"> final int columnCount = metaData.getColumnCount();</span> +<span class="fc" id="L945"> labels = new String[columnCount];</span> +<span class="fc bfc" id="L946" title="All 2 branches covered."> for (int i = 0; i < columnCount; i++) {</span> +<span class="fc" id="L947"> labels[i] = metaData.getColumnLabel(i + 1);</span> + } + } +<span class="fc" id="L950"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, labels, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the header comments of the format. The comments will be printed first, before the headers. This setting is + * ignored by the parser. + * + * <pre> + * CSVFormat format = aformat.withHeaderComments(&quot;Generated by Apache Commons CSV 1.1.&quot;, new Date()); + * </pre> + * + * @param headerComments + * the headerComments which will be printed by the Printer before the actual CSV data. + * + * @return A new CSVFormat that is equal to this but with the specified header + * @see #withSkipHeaderRecord(boolean) + * @since 1.1 + */ + public CSVFormat withHeaderComments(final Object... headerComments) { +<span class="fc" id="L971"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, headerComments, header, + skipHeaderRecord, allowMissingColumnNames); + } + + /** + * Sets the missing column names behavior of the format to {@code true} + * + * @return A new CSVFormat that is equal to this but with the specified missing column names behavior. + * @see #withAllowMissingColumnNames(boolean) + * @since 1.1 + */ + public CSVFormat withAllowMissingColumnNames() { +<span class="fc" id="L984"> return this.withAllowMissingColumnNames(true);</span> + } + + /** + * Sets the missing column names behavior of the format. + * + * @param allowMissingColumnNames + * the missing column names behavior, {@code true} to allow missing column names in the header line, + * {@code false} to cause an {@link IllegalArgumentException} to be thrown. + * @return A new CSVFormat that is equal to this but with the specified missing column names behavior. + */ + public CSVFormat withAllowMissingColumnNames(final boolean allowMissingColumnNames) { +<span class="fc" id="L996"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the empty line skipping behavior of the format to {@code true}. + * + * @return A new CSVFormat that is equal to this but with the specified empty line skipping behavior. + * @since {@link #withIgnoreEmptyLines(boolean)} + * @since 1.1 + */ + public CSVFormat withIgnoreEmptyLines() { +<span class="fc" id="L1009"> return this.withIgnoreEmptyLines(true);</span> + } + + /** + * Sets the empty line skipping behavior of the format. + * + * @param ignoreEmptyLines + * the empty line skipping behavior, {@code true} to ignore the empty lines between the records, + * {@code false} to translate empty lines to empty records. + * @return A new CSVFormat that is equal to this but with the specified empty line skipping behavior. + */ + public CSVFormat withIgnoreEmptyLines(final boolean ignoreEmptyLines) { +<span class="fc" id="L1021"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the trimming behavior of the format to {@code true}. + * + * @return A new CSVFormat that is equal to this but with the specified trimming behavior. + * @see #withIgnoreSurroundingSpaces(boolean) + * @since 1.1 + */ + public CSVFormat withIgnoreSurroundingSpaces() { +<span class="fc" id="L1034"> return this.withIgnoreSurroundingSpaces(true);</span> + } + + /** + * Sets the trimming behavior of the format. + * + * @param ignoreSurroundingSpaces + * the trimming behavior, {@code true} to remove the surrounding spaces, {@code false} to leave the + * spaces as is. + * @return A new CSVFormat that is equal to this but with the specified trimming behavior. + */ + public CSVFormat withIgnoreSurroundingSpaces(final boolean ignoreSurroundingSpaces) { +<span class="fc" id="L1046"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Performs conversions to and from null for strings on input and output. + * <ul> + * <li> + * <strong>Reading:</strong> Converts strings equal to the given {@code nullString} to {@code null} when reading + * records.</li> + * <li> + * <strong>Writing:</strong> Writes {@code null} as the given {@code nullString} when writing records.</li> + * </ul> + * + * @param nullString + * the String to convert to and from {@code null}. No substitution occurs if {@code null} + * + * @return A new CSVFormat that is equal to this but with the specified null conversion string. + */ + public CSVFormat withNullString(final String nullString) { +<span class="fc" id="L1067"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the quoteChar of the format to the specified character. + * + * @param quoteChar + * the quoteChar character + * @return A new CSVFormat that is equal to this but with the specified character as quoteChar + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withQuote(final char quoteChar) { +<span class="fc" id="L1082"> return withQuote(Character.valueOf(quoteChar));</span> + } + + /** + * Sets the quoteChar of the format to the specified character. + * + * @param quoteChar + * the quoteChar character, use {@code null} to disable + * @return A new CSVFormat that is equal to this but with the specified character as quoteChar + * @throws IllegalArgumentException + * thrown if the specified character is a line break + */ + public CSVFormat withQuote(final Character quoteChar) { +<span class="fc bfc" id="L1095" title="All 2 branches covered."> if (isLineBreak(quoteChar)) {</span> +<span class="fc" id="L1096"> throw new IllegalArgumentException("The quoteChar cannot be a line break");</span> + } +<span class="fc" id="L1098"> return new CSVFormat(delimiter, quoteChar, quoteMode, commentMarker, escapeCharacter, ignoreSurroundingSpaces,</span> + ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, allowMissingColumnNames); + } + + /** + * Sets the output quote policy of the format to the specified value. + * + * @param quoteModePolicy + * the quote policy to use for output. + * + * @return A new CSVFormat that is equal to this but with the specified quote policy + */ + public CSVFormat withQuoteMode(final QuoteMode quoteModePolicy) { +<span class="fc" id="L1111"> return new CSVFormat(delimiter, quoteCharacter, quoteModePolicy, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets the record separator of the format to the specified character. + * + * <p> + * <strong>Note:</strong> This setting is only used during printing and does not affect parsing. Parsing currently + * only works for inputs with '\n', '\r' and "\r\n" + * </p> + * + * @param recordSeparator + * the record separator to use for output. + * + * @return A new CSVFormat that is equal to this but with the the specified output record separator + */ + public CSVFormat withRecordSeparator(final char recordSeparator) { +<span class="fc" id="L1130"> return withRecordSeparator(String.valueOf(recordSeparator));</span> + } + + /** + * Sets the record separator of the format to the specified String. + * + * <p> + * <strong>Note:</strong> This setting is only used during printing and does not affect parsing. Parsing currently + * only works for inputs with '\n', '\r' and "\r\n" + * </p> + * + * @param recordSeparator + * the record separator to use for output. + * + * @return A new CSVFormat that is equal to this but with the the specified output record separator + * @throws IllegalArgumentException + * if recordSeparator is none of CR, LF or CRLF + */ + public CSVFormat withRecordSeparator(final String recordSeparator) { +<span class="fc" id="L1149"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } + + /** + * Sets skipping the header record to {@code true}. + * + * @return A new CSVFormat that is equal to this but with the the specified skipHeaderRecord setting. + * @see #withSkipHeaderRecord(boolean) + * @see #withHeader(String...) + * @since 1.1 + */ + public CSVFormat withSkipHeaderRecord() { +<span class="fc" id="L1163"> return this.withSkipHeaderRecord(true);</span> + } + + /** + * Sets whether to skip the header record. + * + * @param skipHeaderRecord + * whether to skip the header record. + * + * @return A new CSVFormat that is equal to this but with the the specified skipHeaderRecord setting. + * @see #withHeader(String...) + */ + public CSVFormat withSkipHeaderRecord(final boolean skipHeaderRecord) { +<span class="fc" id="L1176"> return new CSVFormat(delimiter, quoteCharacter, quoteMode, commentMarker, escapeCharacter,</span> + ignoreSurroundingSpaces, ignoreEmptyLines, recordSeparator, nullString, null, header, skipHeaderRecord, + allowMissingColumnNames); + } +} +</pre><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html> \ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVFormat.java.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVFormat.java.html ------------------------------------------------------------------------------ svn:keywords = Id Added: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$1.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$1.html (added) +++ websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$1.html Wed Nov 26 15:56:58 2014 @@ -0,0 +1 @@ +<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>CSVParser.new Iterator() {...}</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CSV</a> > <a href="index.html" class="el_package">org.apache.commons.csv</a> > <span class="el_class">CSVParser.new Iterator() {...}</span></div><h1>CSVParser.new Iterator() {...}</h1><table class="coverage" cellspacing="0" i d="coveragetable"><thead><tr><td class="sortable" id="a" onclick="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">6 of 69</td><td class="ctr2">91%</td><td class="bar">0 of 12</td><td class="ctr2">100%</td><td class="ctr1">0</td><td class="ctr2">11</td><td class="ctr1">2</td><td class="ctr2">19</td><td class="ctr1">0</td><td class="ctr2">5</td></tr></tfoot><tbody><tr><td id="a0"><a href="CSVParser.java.html#L439" class="el_method">getNextRecord()</a></td><td class="bar" id="b0"><img src="../.resources/redbar.gif" width="24" height="10" title="6" alt="6"/><img src="../.resources/greenbar.gif" width="16" height="10" title="4" alt="4"/></td><td class="ctr2" id="c4">40%</td><td class="bar" id="d2"/><td class="ctr2" id="e2">n/a</td><td class="ctr1" id="f0">0</td><td class="ctr2" id="g2">1</td><td class="ctr1" id="h0">2</td><td class="ctr2" id="i2">3</td><td class="ctr1" id="j0">0</td><td class="ctr2" id="k0">1</td></tr><tr><td id="a2"><a href="CSVParser.java.html#L460" class="el_method">next()</a></td><td class="bar" id="b1"><img src="../.resources/greenbar.gif" width="120" height="10" title="29" alt="29"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d0"><img src="../.resources/greenbar.gif" width="120 " height="10" title="6" alt="6"/></td><td class="ctr2" id="e0">100%</td><td class="ctr1" id="f1">0</td><td class="ctr2" id="g0">4</td><td class="ctr1" id="h1">0</td><td class="ctr2" id="i0">9</td><td class="ctr1" id="j1">0</td><td class="ctr2" id="k1">1</td></tr><tr><td id="a1"><a href="CSVParser.java.html#L448" class="el_method">hasNext()</a></td><td class="bar" id="b2"><img src="../.resources/greenbar.gif" width="82" height="10" title="20" alt="20"/></td><td class="ctr2" id="c1">100%</td><td class="bar" id="d1"><img src="../.resources/greenbar.gif" width="120" height="10" title="6" alt="6"/></td><td class="ctr2" id="e1">100%</td><td class="ctr1" id="f2">0</td><td class="ctr2" id="g1">4</td><td class="ctr1" id="h2">0</td><td class="ctr2" id="i1">5</td><td class="ctr1" id="j2">0</td><td class="ctr2" id="k2">1</td></tr><tr><td id="a4"><a href="CSVParser.java.html#L434" class="el_method">{...}</a></td><td class="bar" id="b3"><img src="../.resources/greenbar.gif" width="24" height="10" title="6" alt="6"/></td><td class="ctr2" id="c2">100%</td><td class="bar" id="d3"/><td class="ctr2" id="e3">n/a</td><td class="ctr1" id="f3">0</td><td class="ctr2" id="g3">1</td><td class="ctr1" id="h3">0</td><td class="ctr2" id="i3">1</td><td class="ctr1" id="j3">0</td><td class="ctr2" id="k3">1</td></tr><tr><td id="a3"><a href="CSVParser.java.html#L479" class="el_method">remove()</a></td><td class="bar" id="b4"><img src="../.resources/greenbar.gif" width="16" height="10" title="4" alt="4"/></td><td class="ctr2" id="c3">100%</td><td class="bar" id="d4"/><td class="ctr2" id="e4">n/a</td><td class="ctr1" id="f4">0</td><td class="ctr2" id="g4">1</td><td class="ctr1" id="h4">0</td><td class="ctr2" id="i4">1</td><td class="ctr1" id="j4">0</td><td class="ctr2" id="k4">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html> \ No newline at end of file Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$1.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$1.html ------------------------------------------------------------------------------ svn:keywords = Id Added: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$2.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$2.html (added) +++ websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$2.html Wed Nov 26 15:56:58 2014 @@ -0,0 +1 @@ +<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>CSVParser.new Object() {...}</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CSV</a> > <a href="index.html" class="el_package">org.apache.commons.csv</a> > <span class="el_class">CSVParser.new Object() {...}</span></div><h1>CSVParser.new Object() {...}</h1><table class="coverage" cellspacing="0" id="cov eragetable"><thead><tr><td class="sortable" id="a" onclick="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">5 of 40</td><td class="ctr2">88%</td><td class="bar">0 of 0</td><td class="ctr2">n/a</td><td class="ctr1">0</td><td class="c tr2">1</td><td class="ctr1">0</td><td class="ctr2">1</td><td class="ctr1">0</td><td class="ctr2">1</td></tr></tfoot><tbody><tr><td id="a0"><a href="CSVParser.java.html#L499" class="el_method">static {...}</a></td><td class="bar" id="b0"><img src="../.resources/redbar.gif" width="15" height="10" title="5" alt="5"/><img src="../.resources/greenbar.gif" width="105" height="10" title="35" alt="35"/></td><td class="ctr2" id="c0">88%</td><td class="bar" id="d0"/><td class="ctr2" id="e0">n/a</td><td class="ctr1" id="f0">0</td><td class="ctr2" id="g0">1</td><td class="ctr1" id="h0">0</td><td class="ctr2" id="i0">1</td><td class="ctr1" id="j0">0</td><td class="ctr2" id="k0">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html> \ No newline at end of file Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$2.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser$2.html ------------------------------------------------------------------------------ svn:keywords = Id Added: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser.html ============================================================================== --- websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser.html (added) +++ websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser.html Wed Nov 26 15:56:58 2014 @@ -0,0 +1 @@ +<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>CSVParser</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CSV</a> > <a href="index.html" class="el_package">org.apache.commons.csv</a> > <span class="el_class">CSVParser</span></div><h1>CSVParser</h1><table class="coverage" cellspacing="0" id="coveragetable"><thead><tr><td class="sortable" id="a" onclic k="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">29 of 418</td><td class="ctr2">93%</td><td class="bar">6 of 50</td><td class="ctr2">88%</td><td class="ctr1">6</td><td class="ctr2">42</td><td class="ctr1">2</td><td class="ctr2">92 </td><td class="ctr1">0</td><td class="ctr2">15</td></tr></tfoot><tbody><tr><td id="a11"><a href="CSVParser.java.html#L492" class="el_method">nextRecord()</a></td><td class="bar" id="b0"><img src="../.resources/redbar.gif" width="25" height="10" title="29" alt="29"/><img src="../.resources/greenbar.gif" width="94" height="10" title="107" alt="107"/></td><td class="ctr2" id="c14">79%</td><td class="bar" id="d1"><img src="../.resources/redbar.gif" width="10" height="10" title="2" alt="2"/><img src="../.resources/greenbar.gif" width="70" height="10" title="14" alt="14"/></td><td class="ctr2" id="e3">88%</td><td class="ctr1" id="f1">2</td><td class="ctr2" id="g1">11</td><td class="ctr1" id="h0">2</td><td class="ctr2" id="i0">27</td><td class="ctr1" id="j0">0</td><td class="ctr2" id="k0">1</td></tr><tr><td id="a8"><a href="CSVParser.java.html#L378" class="el_method">initializeHeader()</a></td><td class="bar" id="b1"><img src="../.resources/greenbar.gif" width="86" height="10" title="98" alt="98"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d0"><img src="../.resources/redbar.gif" width="15" height="10" title="3" alt="3"/><img src="../.resources/greenbar.gif" width="105" height="10" title="21" alt="21"/></td><td class="ctr2" id="e4">88%</td><td class="ctr1" id="f0">3</td><td class="ctr2" id="g0">13</td><td class="ctr1" id="h1">0</td><td class="ctr2" id="i1">24</td><td class="ctr1" id="j1">0</td><td class="ctr2" id="k1">1</td></tr><tr><td id="a3"><a href="CSVParser.java.html#L218" class="el_method">CSVParser(Reader, CSVFormat, long, long)</a></td><td class="bar" id="b2"><img src="../.resources/greenbar.gif" width="38" height="10" title="44" alt="44"/></td><td class="ctr2" id="c1">100%</td><td class="bar" id="d6"/><td class="ctr2" id="e6">n/a</td><td class="ctr1" id="f3">0</td><td class="ctr2" id="g6">1</td><td class="ctr1" id="h2">0</td><td class="ctr2" id="i2">11</td><td class="ctr1" id="j2">0</td><td class="ctr2" id="k2">1</td></tr><tr><td id="a0"><a href="CSVParser.java.html#L289" class="el_method">addRecordValue()</a></td><td class="bar" id="b3"><img src="../.resources/greenbar.gif" width="25" height="10" title="29" alt="29"/></td><td class="ctr2" id="c2">100%</td><td class="bar" id="d3"><img src="../.resources/greenbar.gif" width="20" height="10" title="4" alt="4"/></td><td class="ctr2" id="e0">100%</td><td class="ctr1" id="f4">0</td><td class="ctr2" id="g2">3</td><td class="ctr1" id="h3">0</td><td class="ctr2" id="i3">6</td><td class="ctr1" id="j3">0</td><td class="ctr2" id="k3">1</td></tr><tr><td id="a14"><a href="CSVParser.java.html#L201" class="el_method">parse(URL, Charset, CSVFormat)</a></td><td class="bar" id="b4"><img src="../.resources/greenbar.gif" width="17" height="10" title="20" alt="20"/></td><td class="ctr2" id="c3">100%</td><td class="bar" id="d7"/><td class="ctr2" id="e7">n/a</td><td class="ctr1" id="f5">0</td><td class="ctr2" id="g7">1</td><td class="ctr1" id="h4">0</td><td class="ctr2" id="i4">4</td><td cla ss="ctr1" id="j4">0</td><td class="ctr2" id="k4">1</td></tr><tr><td id="a12"><a href="CSVParser.java.html#L155" class="el_method">parse(File, Charset, CSVFormat)</a></td><td class="bar" id="b5"><img src="../.resources/greenbar.gif" width="16" height="10" title="19" alt="19"/></td><td class="ctr2" id="c4">100%</td><td class="bar" id="d8"/><td class="ctr2" id="e8">n/a</td><td class="ctr1" id="f6">0</td><td class="ctr2" id="g8">1</td><td class="ctr1" id="h5">0</td><td class="ctr2" id="i6">3</td><td class="ctr1" id="j5">0</td><td class="ctr2" id="k5">1</td></tr><tr><td id="a7"><a href="CSVParser.java.html#L364" class="el_method">getRecords()</a></td><td class="bar" id="b6"><img src="../.resources/greenbar.gif" width="14" height="10" title="16" alt="16"/></td><td class="ctr2" id="c5">100%</td><td class="bar" id="d4"><img src="../.resources/greenbar.gif" width="10" height="10" title="2" alt="2"/></td><td class="ctr2" id="e1">100%</td><td class="ctr1" id="f7">0</td><td class="ctr2" id="g3" >2</td><td class="ctr1" id="h6">0</td><td class="ctr2" id="i5">4</td><td >class="ctr1" id="j6">0</td><td class="ctr2" id="k6">1</td></tr><tr><td >id="a13"><a href="CSVParser.java.html#L174" class="el_method">parse(String, >CSVFormat)</a></td><td class="bar" id="b7"><img >src="../.resources/greenbar.gif" width="13" height="10" title="15" >alt="15"/></td><td class="ctr2" id="c6">100%</td><td class="bar" id="d9"/><td >class="ctr2" id="e9">n/a</td><td class="ctr1" id="f8">0</td><td class="ctr2" >id="g9">1</td><td class="ctr1" id="h7">0</td><td class="ctr2" >id="i7">3</td><td class="ctr1" id="j7">0</td><td class="ctr2" >id="k7">1</td></tr><tr><td id="a5"><a href="CSVParser.java.html#L333" >class="el_method">getHeaderMap()</a></td><td class="bar" id="b8"><img >src="../.resources/greenbar.gif" width="9" height="10" title="11" >alt="11"/></td><td class="ctr2" id="c7">100%</td><td class="bar" id="d5"><img >src="../.resources/greenbar.gif" width="10" height="10" title="2" >alt="2"/></td><td class="ctr2" id ="e2">100%</td><td class="ctr1" id="f9">0</td><td class="ctr2" id="g4">2</td><td class="ctr1" id="h8">0</td><td class="ctr2" id="i10">1</td><td class="ctr1" id="j8">0</td><td class="ctr2" id="k8">1</td></tr><tr><td id="a2"><a href="CSVParser.java.html#L251" class="el_method">CSVParser(Reader, CSVFormat)</a></td><td class="bar" id="b9"><img src="../.resources/greenbar.gif" width="6" height="10" title="7" alt="7"/></td><td class="ctr2" id="c8">100%</td><td class="bar" id="d10"/><td class="ctr2" id="e10">n/a</td><td class="ctr1" id="f10">0</td><td class="ctr2" id="g10">1</td><td class="ctr1" id="h9">0</td><td class="ctr2" id="i9">2</td><td class="ctr1" id="j9">0</td><td class="ctr2" id="k9">1</td></tr><tr><td id="a1"><a href="CSVParser.java.html#L306" class="el_method">close()</a></td><td class="bar" id="b10"><img src="../.resources/greenbar.gif" width="6" height="10" title="7" alt="7"/></td><td class="ctr2" id="c9">100%</td><td class="bar" id="d2"><img src="../.resources/redbar.gif" w idth="5" height="10" title="1" alt="1"/><img src="../.resources/greenbar.gif" width="5" height="10" title="1" alt="1"/></td><td class="ctr2" id="e5">50%</td><td class="ctr1" id="f2">1</td><td class="ctr2" id="g5">2</td><td class="ctr1" id="h10">0</td><td class="ctr2" id="i8">3</td><td class="ctr1" id="j10">0</td><td class="ctr2" id="k10">1</td></tr><tr><td id="a10"><a href="CSVParser.java.html#L434" class="el_method">iterator()</a></td><td class="bar" id="b11"><img src="../.resources/greenbar.gif" width="4" height="10" title="5" alt="5"/></td><td class="ctr2" id="c10">100%</td><td class="bar" id="d11"/><td class="ctr2" id="e11">n/a</td><td class="ctr1" id="f11">0</td><td class="ctr2" id="g11">1</td><td class="ctr1" id="h11">0</td><td class="ctr2" id="i11">1</td><td class="ctr1" id="j11">0</td><td class="ctr2" id="k11">1</td></tr><tr><td id="a4"><a href="CSVParser.java.html#L322" class="el_method">getCurrentLineNumber()</a></td><td class="bar" id="b12"><img src="../.resources/greenba r.gif" width="3" height="10" title="4" alt="4"/></td><td class="ctr2" id="c11">100%</td><td class="bar" id="d12"/><td class="ctr2" id="e12">n/a</td><td class="ctr1" id="f12">0</td><td class="ctr2" id="g12">1</td><td class="ctr1" id="h12">0</td><td class="ctr2" id="i12">1</td><td class="ctr1" id="j12">0</td><td class="ctr2" id="k12">1</td></tr><tr><td id="a9"><a href="CSVParser.java.html#L421" class="el_method">isClosed()</a></td><td class="bar" id="b13"><img src="../.resources/greenbar.gif" width="3" height="10" title="4" alt="4"/></td><td class="ctr2" id="c12">100%</td><td class="bar" id="d13"/><td class="ctr2" id="e13">n/a</td><td class="ctr1" id="f13">0</td><td class="ctr2" id="g13">1</td><td class="ctr1" id="h13">0</td><td class="ctr2" id="i13">1</td><td class="ctr1" id="j13">0</td><td class="ctr2" id="k13">1</td></tr><tr><td id="a6"><a href="CSVParser.java.html#L347" class="el_method">getRecordNumber()</a></td><td class="bar" id="b14"><img src="../.resources/greenbar.gif" width ="2" height="10" title="3" alt="3"/></td><td class="ctr2" id="c13">100%</td><td class="bar" id="d14"/><td class="ctr2" id="e14">n/a</td><td class="ctr1" id="f14">0</td><td class="ctr2" id="g14">1</td><td class="ctr1" id="h14">0</td><td class="ctr2" id="i14">1</td><td class="ctr1" id="j14">0</td><td class="ctr2" id="k14">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html> \ No newline at end of file Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: websites/production/commons/content/proper/commons-csv/archives/1.1/jacoco/org.apache.commons.csv/CSVParser.html ------------------------------------------------------------------------------ svn:keywords = Id