Thanks to visit codestin.com
Credit goes to github.com

Skip to content

JavaDoc generated from XML may contain malformed html #581

@Lukiz

Description

@Lukiz

I have sample xsd that looks like this:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Data">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Age" type="xs:unsignedByte" />
                <xs:element name="Under18" type="xs:boolean" >
                    <xs:annotation>
                        <xs:documentation>Resolve age &lt;&gt; 18</xs:documentation>
                    </xs:annotation>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

After generating java code the entity for less-then sign &lt; is not preserved as escaped entity but replaced with proper character <.

    /**
     * Resolve age <> 18
     * 
     */
    @XmlElement(name = "Under18")
    protected boolean under18;

It leads to invalid HTML.
Our project has check for valid JavaDoc and fails on malformed HTML.

Metadata

Metadata

Labels

bug-externalIssue concerns an external dependency

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions