<change id="multiple-annotation-type">

             <api name="EditorHintsSPI"/>

             <summary>Support multiple ranges for ErrorDescriptor</summary>

             <version major="1" minor="42" subsubminor="0"/>

             <date day="17" month="7" year="2017"/>

             <author login="mromashova"/>

             <compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

             <description>

                 Added support for multiple ranges for error/warning. New field added to ErrorDescription  as well as corresponding getter method and new constructor 

                 in order to be able to provide multiple ranges support for highlight  particular hint. Added new factory method to

                 ErrorDescriptionFactory which uses new ErrorDescription constructor.

             </description>

             <issue number="271070"/>

        </change>        

    private static void addHighlights(List<int[]> currentHighlights, PositionBounds pos) throws IOException {

        int beginOffset = pos.getBegin().getPosition().getOffset();

        int endOffset = pos.getEnd().getPosition().getOffset();

        if (endOffset < beginOffset) {

            //see issue #112566

            int swap = endOffset;

            endOffset = beginOffset;

            beginOffset = swap;

            LOG.log(Level.WARNING, "Incorrect highlight in ErrorDescription, attach your messages.log to issue #112566: {0}", pos.toString()); //NOI18N

        }

        int[] h = new int[]{beginOffset, endOffset};

        OUT:

        for (Iterator<int[]> it = currentHighlights.iterator(); it.hasNext() && h != null;) {

            int[] hl = it.next();

            switch (detectCollisions(hl, h)) {

                case 0:

                    break;

                case 1:

                    it.remove();

                    break;

                case 2:

                    h = null; //nothing to add, hl is bigger:

                    break OUT;

                case 4:

                case 3:

                    int start = Math.min(hl[0], h[0]);

                    int end = Math.max(hl[1], h[1]);

                    h = new int[]{start, end};

                    it.remove();

                    break;

            }

        }

        if (h != null) {

            currentHighlights.add(h);

        }        

    }

import java.util.ArrayList;

    private final ArrayList<PositionBounds> spanTail = new ArrayList<>();

    ErrorDescription(FileObject file, String id, String description, CharSequence details, Severity severity, String customType, LazyFixList fixes, 

            PositionBounds span, ArrayList<PositionBounds> spanTail) {

        this.id = id;

        this.description = description;

        this.details = details;

        this.severity    = severity;

        this.customType = customType;

        this.fixes       = fixes;

        this.span        = span;

        this.spanTail.clear();

        this.spanTail.addAll(spanTail);

        this.file        = file;

    }

    /**

     *  Return range tail: to support multiple ranges for error/warning

     * @return 

     * @since 1.42

     */

    public ArrayList<PositionBounds> getRangeTail() {

        return spanTail;

    }

import java.util.ArrayList;

import java.util.logging.Level;

import java.util.logging.Logger;

 /**Create a new {@link ErrorDescription} with the given parameters.

     *

     * Should be called inside document read lock to assure consistency

     *

     * @param id an optional ID of the {@link ErrorDescription}. Should represent a "type" of an error/warning.

     *           It is recommended that providers prefix the ID with their unique prefix.

     * @param severity the desired {@link Severity}

     * @param customType

     * @param description the text of the error/warning

     * @param details optional "more details" describing the error/warning

     * @param fixes a collection of {@link Fix}es that should be shown for the error/warning

     * @param file for which the {@link ErrorDescription} should be created

     * @param starts the array of start offsets for error/warning

     * @param ends the array of end offsets for error/warning

     * @return a newly created {@link ErrorDescription} based on the given parameters

     * @since 1.42

     */

    public static @NonNull ErrorDescription createErrorDescription(@NullAllowed String id, @NonNull Severity severity, 

            @NullAllowed String customType, @NonNull String description, @NullAllowed CharSequence details, @NonNull LazyFixList fixes, 

            @NonNull FileObject file, int[] starts, int[] ends) {

        Parameters.notNull("severity", severity);

        Parameters.notNull("description", description);

        Parameters.notNull("fixes", fixes);

        Parameters.notNull("file", file);

        if (starts == null || starts.length == 0 || starts[0] < 0) throw new IndexOutOfBoundsException("start < 0 (" + starts + " < 0)");;//NOI18N

        if (ends == null || ends.length == 0 || ends[0] < 0) throw new IndexOutOfBoundsException("end < 0 (" + ends + " < 0)");;//NOI18N

        if (ends.length != starts.length) throw new IndexOutOfBoundsException("starts lentgh:" + starts.length + " != " + ends.length + " ends length");//NOI18N

        PositionBounds span = HintsControllerImpl.linePart(file, starts[0], ends[0]);

        ArrayList<PositionBounds> spanTail = new ArrayList<>();

        if (starts.length > 1) {

            for (int i = 1; i < starts.length; i++) {

                //just skip if starts greater or equals to end

                if (starts[i] >= ends[i]) {

                    //log and continue

                    Logger.getLogger(ErrorDescriptionFactory.class.getName()).log(Level.INFO, "Incorrect span,  start=" + starts[i] + ", end=" + ends[i], new Exception());;//NOI18N

                    continue;

                }

                spanTail.add(HintsControllerImpl.linePart(file, starts[i], ends[i]));

            }

        }

        return new ErrorDescription(file, id, description, details, severity, customType, fixes, span, spanTail);

    }    

    /**Create a new {@link ErrorDescription} with the given parameters.

     *

     * @param id an optional ID of the {@link ErrorDescription}. Should represent a "type" of an error/warning.

     *           It is recommended that providers prefix the ID with their unique prefix.

     * @param severity the desired {@link Severity}

     * @param customType custom annotation type

     * @param description the text of the error/warning

     * @param details optional "more details" describing the error/warning

     * @param fixes a collection of {@link Fix}es that should be shown for the error/warning

     * @param doc document for which the {@link ErrorDescription} should be created

     * @param starts the array of start offsets for error/warning

     * @param ends the array of end offsets for error/warning

     * @return a newly created {@link ErrorDescription} based on the given parameters

     * @since 1.42

     */

    public static @NonNull ErrorDescription createErrorDescription(@NullAllowed String id, @NonNull Severity severity, 

            @NullAllowed String customType, @NonNull String description, @NullAllowed CharSequence details,  @NonNull List<Fix> fixes, 

            @NonNull Document doc, int[] starts, int[] ends) {

        Parameters.notNull("severity", severity);

        Parameters.notNull("description", description);

        Parameters.notNull("fixes", fixes);

        Parameters.notNull("doc", doc);

        DataObject od = (DataObject) doc.getProperty(Document.StreamDescriptionProperty);

        FileObject file = od != null ? od.getPrimaryFile() : null;

        if (starts == null || starts.length == 0 || starts[0] < 0) throw new IndexOutOfBoundsException("start < 0 (" + starts + " < 0)");;//NOI18N

        if (ends == null || ends.length == 0 || ends[0] < 0) throw new IndexOutOfBoundsException("end < 0 (" + ends + " < 0)");;//NOI18N

        if (ends.length != starts.length) throw new IndexOutOfBoundsException("starts lentgh:" + starts.length + " != " + ends.length + " ends length");//NOI18N

        PositionBounds span = HintsControllerImpl.linePart(file, starts[0], ends[0]);

        ArrayList<PositionBounds> spanTail = new ArrayList<>();

        if (starts.length > 1) {

            for (int i = 1; i < starts.length; i++) {

                //just skip if starts greater or equals to end

                if (starts[i] >= ends[i]) {

                    //log and continue

                    Logger.getLogger(ErrorDescriptionFactory.class.getName()).log(Level.INFO, "Incorrect span,  start=" + starts[i] + ", end=" + ends[i], new Exception());;//NOI18N

                    continue;

                }

                spanTail.add(HintsControllerImpl.linePart(file, starts[i], ends[i]));

            }

        }

        return new ErrorDescription(file, id, description, details, severity, customType, new StaticFixList(fixes), 

                span, spanTail);

    }