Question

I don’t know why, but it’s been a problem for quite some time now.

I can’t seem to generate Java Doc for most of my applications using NetBeans 7.2 (had the same problem with 7.1). I simply can’t figure out why I get this error:

java.lang.IllegalArgumentException: Error decoding percent encoded characters

I know what the error means (English duh), but I can’t find out why it says this. As far as I could see in my Documentation there shouldn’t be any “percent encoded characters” unless I am missing what that means entirely.

Here is the entire code (one file only, and it’s an interface so it’s rather short):

package access;

import exception.DataException;
import java.util.List;
import table.Row;

/**
 *
 * @author Vipar
 */
public interface DataAccessor {
    /**
     * Reads data from a table.
     * 
     * @param table The table.
     * 
     * @param columns The columns to read, or null to read 
     * all the columns in the table.
     * 
     * @param selectionRow A set of filter columns and values 
     * use to subset the rows, or null to 
     * read all the rows in the table.
     * 
     * @param sortColumns The columns to sort, or null to read 
     * without sorting.
     * 
     * @return The list of rows.
     */
    List read(String table,
            String[] columns,
            Row selectionRow,
            String[] sortColumns) throws DataException;

    /**
     * Inserts data into a table.
     * 
     * @param table The table.
     * @param rows The rows to insert
     */
    void insert(String table, List rows) throws DataException;

    /**
     * Updates data in a table.
     * 
     * @param table The table.
     * 
     * @param selectionRow A set of filter columns and values 
     * used to subset the rows, or null to 
     * update all of the rows in the table.
     * 
     * @param updateRow A set of update columns and values.
     */
    void update(String table,
            Row selectionRow,
            Row updateRow) throws DataException;

    /**
     * Deletes data from a table.
     * 
     * @param table The table.
     * 
     * @param selectionRow A set of filter columns and values 
     * used to subset the rows, or null to 
     * delete all of the rows in the table.
     */
    void delete(String table,
            Row selectionRow) throws DataException;
}

Row and DataException does not have any documentation because currently both are empty. I just wanted to test how the documentation would look.

I use Java 1.7

Answer 1

I tested your class –> javadoc is generated as usual.

Please check these settings (contextmenu of project -> Properties):

• Sources -> Encoding: UTF-8: What do you have here?
• Build -> Documenting: Do you have set some Javadoc Options? If you have settings in this textfield remove them and try again. Btw. what are your settings at Documenting?
• Since there’s no issue for this Exception, feel free to open one.