1.1 --- a/hudson/trunk	Wed May 01 21:53:41 2013 +0200
     1.2 +++ b/hudson/trunk	Wed May 08 21:47:42 2013 +0200
     1.3 @@ -41,7 +41,7 @@
     1.4  
     1.5  ant -Dnbplatform.active.dir=$PLATFORM -f lib/download.xml download copy-from-platform
     1.6  
     1.7 -SUBPROJECTS="remoting duplicates language cmdline";
     1.8 +SUBPROJECTS="remoting duplicates language java.hints cmdline";
     1.9  
    1.10  for subproject in $SUBPROJECTS; do
    1.11      (cd $subproject; ./build.sh -Dnbplatform.default.harness.dir=$PLATFORM/harness -Dnbplatform.default.netbeans.dest.dir=$PLATFORM -Dnbplatform.active.dir=$PLATFORM) || exit 1

     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/java.hints/build.sh	Wed May 08 21:47:42 2013 +0200
     2.3 @@ -0,0 +1,3 @@
     2.4 +#!/bin/bash
     2.5 +ant "$@" clean && ant "$@" nbms && ant "$@" test || exit 1
     2.6 +

     3.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     3.2 +++ b/java.hints/build.xml	Wed May 08 21:47:42 2013 +0200
     3.3 @@ -0,0 +1,8 @@
     3.4 +<?xml version="1.0" encoding="UTF-8"?>
     3.5 +<!-- You may freely edit this file. See harness/README in the NetBeans platform -->
     3.6 +<!-- for some information on what you could do (e.g. targets to override). -->
     3.7 +<!-- If you delete this file and reopen the project it will be recreated. -->
     3.8 +<project name="java.hints" basedir=".">
     3.9 +    <description>Builds the module suite java.hints.</description>
    3.10 +    <import file="nbproject/build-impl.xml"/>
    3.11 +</project>

     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/java.hints/nbproject/build-impl.xml	Wed May 08 21:47:42 2013 +0200
     4.3 @@ -0,0 +1,50 @@
     4.4 +<?xml version="1.0" encoding="UTF-8"?>
     4.5 +<!--
     4.6 +*** GENERATED FROM project.xml - DO NOT EDIT  ***
     4.7 +***         EDIT ../build.xml INSTEAD         ***
     4.8 +-->
     4.9 +<project name="java.hints-impl" basedir=".." xmlns:sproject="http://www.netbeans.org/ns/nb-module-suite-project/1">
    4.10 +    <fail message="Please build using Ant 1.7.1 or higher.">
    4.11 +        <condition>
    4.12 +            <not>
    4.13 +                <antversion atleast="1.7.1"/>
    4.14 +            </not>
    4.15 +        </condition>
    4.16 +    </fail>
    4.17 +    <property file="nbproject/private/platform-private.properties"/>
    4.18 +    <property file="nbproject/platform.properties"/>
    4.19 +    <macrodef name="property" uri="http://www.netbeans.org/ns/nb-module-suite-project/1">
    4.20 +        <attribute name="name"/>
    4.21 +        <attribute name="value"/>
    4.22 +        <sequential>
    4.23 +            <property name="@{name}" value="${@{value}}"/>
    4.24 +        </sequential>
    4.25 +    </macrodef>
    4.26 +    <macrodef name="evalprops" uri="http://www.netbeans.org/ns/nb-module-suite-project/1">
    4.27 +        <attribute name="property"/>
    4.28 +        <attribute name="value"/>
    4.29 +        <sequential>
    4.30 +            <property name="@{property}" value="@{value}"/>
    4.31 +        </sequential>
    4.32 +    </macrodef>
    4.33 +    <property file="${user.properties.file}"/>
    4.34 +    <sproject:property name="harness.dir" value="nbplatform.${nbplatform.active}.harness.dir"/>
    4.35 +    <sproject:property name="nbplatform.active.dir" value="nbplatform.${nbplatform.active}.netbeans.dest.dir"/>
    4.36 +    <sproject:evalprops property="cluster.path.evaluated" value="${cluster.path}"/>
    4.37 +    <fail message="Path to 'platform' cluster missing in $${cluster.path} property or using corrupt Netbeans Platform (missing harness).">
    4.38 +        <condition>
    4.39 +            <not>
    4.40 +                <contains string="${cluster.path.evaluated}" substring="platform"/>
    4.41 +            </not>
    4.42 +        </condition>
    4.43 +    </fail>
    4.44 +    <ant antfile="nbproject/platform.xml"/>
    4.45 +    <fail message="Cannot find NetBeans build harness. ${line.separator}Check that nbplatform.${nbplatform.active}.netbeans.dest.dir and nbplatform.${nbplatform.active}.harness.dir are defined. ${line.separator}On a developer machine these are normally defined in ${user.properties.file}=${netbeans.user}/build.properties ${line.separator}but for automated builds you should pass these properties to Ant explicitly. ${line.separator}You may instead download the harness and platform: -Dbootstrap.url=.../tasks.jar -Dautoupdate.catalog.url=.../updates.xml">
    4.46 +        <condition>
    4.47 +            <not>
    4.48 +                <available file="${harness.dir}/suite.xml"/>
    4.49 +            </not>
    4.50 +        </condition>
    4.51 +    </fail>
    4.52 +    <import file="${harness.dir}/suite.xml"/>
    4.53 +</project>

     5.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     5.2 +++ b/java.hints/nbproject/genfiles.properties	Wed May 08 21:47:42 2013 +0200
     5.3 @@ -0,0 +1,11 @@
     5.4 +build.xml.data.CRC32=85cca5f7
     5.5 +build.xml.script.CRC32=25a1521a
     5.6 +build.xml.stylesheet.CRC32=eaf9f76a@2.58
     5.7 +# This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml.
     5.8 +# Do not edit this file. You may delete it but then the IDE will never regenerate such files for you.
     5.9 +nbproject/build-impl.xml.data.CRC32=85cca5f7
    5.10 +nbproject/build-impl.xml.script.CRC32=82e0fe0b
    5.11 +nbproject/build-impl.xml.stylesheet.CRC32=0f381476@2.58
    5.12 +nbproject/platform.xml.data.CRC32=85cca5f7
    5.13 +nbproject/platform.xml.script.CRC32=db9e1f43
    5.14 +nbproject/platform.xml.stylesheet.CRC32=df8ac4dd@2.58

     6.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     6.2 +++ b/java.hints/nbproject/platform.properties	Wed May 08 21:47:42 2013 +0200
     6.3 @@ -0,0 +1,18 @@
     6.4 +cluster.path=\
     6.5 +    ${nbplatform.active.dir}/apisupport:\
     6.6 +    ${nbplatform.active.dir}/cnd:\
     6.7 +    ${nbplatform.active.dir}/dlight:\
     6.8 +    ${nbplatform.active.dir}/enterprise:\
     6.9 +    ${nbplatform.active.dir}/extide:\
    6.10 +    ${nbplatform.active.dir}/harness:\
    6.11 +    ${nbplatform.active.dir}/ide:\
    6.12 +    ${nbplatform.active.dir}/java:\
    6.13 +    ${nbplatform.active.dir}/nb:\
    6.14 +    ${nbplatform.active.dir}/platform:\
    6.15 +    ${nbplatform.active.dir}/profiler:\
    6.16 +    ${nbplatform.active.dir}/webcommon:\
    6.17 +    ${nbplatform.active.dir}/websvccommon:\
    6.18 +    ../remoting/common/build/cluster
    6.19 +extcluster.../remoting/common/build/cluster.javadoc=
    6.20 +extcluster.../remoting/common/build/cluster.sources=
    6.21 +nbplatform.active=default

     7.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.2 +++ b/java.hints/nbproject/platform.xml	Wed May 08 21:47:42 2013 +0200
     7.3 @@ -0,0 +1,34 @@
     7.4 +<?xml version="1.0" encoding="UTF-8"?>
     7.5 +<project name="platform" default="download" basedir="..">
     7.6 +    <condition property="download.required">
     7.7 +        <and>
     7.8 +            <not>
     7.9 +                <available file="${harness.dir}/suite.xml"/>
    7.10 +            </not>
    7.11 +            <isset property="bootstrap.url"/>
    7.12 +            <isset property="autoupdate.catalog.url"/>
    7.13 +        </and>
    7.14 +    </condition>
    7.15 +    <target name="download" if="download.required">
    7.16 +        <mkdir dir="${harness.dir}"/>
    7.17 +        <pathconvert pathsep="|" property="download.clusters">
    7.18 +            <mapper type="flatten"/>
    7.19 +            <path path="${cluster.path}"/>
    7.20 +        </pathconvert>
    7.21 +        <property name="disabled.modules" value=""/>
    7.22 +        <pathconvert property="module.includes" pathsep="">
    7.23 +            <mapper type="glob" from="${basedir}${file.separator}*" to="(?!\Q*\E)"/>
    7.24 +            <path>
    7.25 +                <filelist files="${disabled.modules}" dir="."/>
    7.26 +            </path>
    7.27 +        </pathconvert>
    7.28 +        <echo message="Downloading clusters ${download.clusters}"/>
    7.29 +        <property name="tasks.jar" location="${java.io.tmpdir}/tasks.jar"/>
    7.30 +        <get src="${bootstrap.url}" dest="${tasks.jar}" usetimestamp="true" verbose="true"/>
    7.31 +        <taskdef name="autoupdate" classname="org.netbeans.nbbuild.AutoUpdate" classpath="${tasks.jar}"/>
    7.32 +        <autoupdate installdir="${nbplatform.active.dir}" updatecenter="${autoupdate.catalog.url}">
    7.33 +            <modules includes="${module.includes}.*" clusters="${download.clusters}"/>
    7.34 +            <modules includes="org[.]netbeans[.]modules[.]apisupport[.]harness" clusters="harness"/>
    7.35 +        </autoupdate>
    7.36 +    </target>
    7.37 +</project>

     8.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     8.2 +++ b/java.hints/nbproject/project.properties	Wed May 08 21:47:42 2013 +0200
     8.3 @@ -0,0 +1,3 @@
     8.4 +modules=\
     8.5 +    ${project.org.netbeans.spi.java.hints}
     8.6 +project.org.netbeans.spi.java.hints=spi.java.hints

     9.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     9.2 +++ b/java.hints/nbproject/project.xml	Wed May 08 21:47:42 2013 +0200
     9.3 @@ -0,0 +1,9 @@
     9.4 +<?xml version="1.0" encoding="UTF-8"?>
     9.5 +<project xmlns="http://www.netbeans.org/ns/project/1">
     9.6 +    <type>org.netbeans.modules.apisupport.project.suite</type>
     9.7 +    <configuration>
     9.8 +        <data xmlns="http://www.netbeans.org/ns/nb-module-suite-project/1">
     9.9 +            <name>java.hints</name>
    9.10 +        </data>
    9.11 +    </configuration>
    9.12 +</project>

    10.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    10.2 +++ b/java.hints/spi.java.hints/apichanges.xml	Wed May 08 21:47:42 2013 +0200
    10.3 @@ -0,0 +1,139 @@
    10.4 +<?xml version="1.0" encoding="UTF-8"?>
    10.5 +<!--
    10.6 +DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    10.7 +
    10.8 +Copyright 2012 Oracle and/or its affiliates. All rights reserved.
    10.9 +
   10.10 +Oracle and Java are registered trademarks of Oracle and/or its affiliates.
   10.11 +Other names may be trademarks of their respective owners.
   10.12 +
   10.13 +The contents of this file are subject to the terms of either the GNU
   10.14 +General Public License Version 2 only ("GPL") or the Common
   10.15 +Development and Distribution License("CDDL") (collectively, the
   10.16 +"License"). You may not use this file except in compliance with the
   10.17 +License. You can obtain a copy of the License at
   10.18 +http://www.netbeans.org/cddl-gplv2.html
   10.19 +or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   10.20 +specific language governing permissions and limitations under the
   10.21 +License.  When distributing the software, include this License Header
   10.22 +Notice in each file and include the License file at
   10.23 +nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
   10.24 +particular file as subject to the "Classpath" exception as provided
   10.25 +by Oracle in the GPL Version 2 section of the License file that
   10.26 +accompanied this code. If applicable, add the following below the
   10.27 +License Header, with the fields enclosed by brackets [] replaced by
   10.28 +your own identifying information:
   10.29 +"Portions Copyrighted [year] [name of copyright owner]"
   10.30 +
   10.31 +If you wish your version of this file to be governed by only the CDDL
   10.32 +or only the GPL Version 2, indicate your decision by adding
   10.33 +"[Contributor] elects to include this software in this distribution
   10.34 +under the [CDDL or GPL Version 2] license." If you do not indicate a
   10.35 +single choice of license, a recipient has the option to distribute
   10.36 +your version of this file under either the CDDL, the GPL Version 2 or
   10.37 +to extend the choice of license to its licensees as provided above.
   10.38 +However, if you add GPL Version 2 code and therefore, elected the GPL
   10.39 +Version 2 license, then the option applies only if the new code is
   10.40 +made subject to such option by the copyright holder.
   10.41 +
   10.42 +Contributor(s):
   10.43 +
   10.44 +Portions Copyrighted 2012 Sun Microsystems, Inc.
   10.45 +-->
   10.46 +<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../nbbuild/javadoctools/apichanges.dtd">
   10.47 +<apichanges>
   10.48 +    <apidefs>
   10.49 +        <apidef name="JavaHintsSPI">Java Hints SPI</apidef>
   10.50 +    </apidefs>
   10.51 +    <changes>
   10.52 +        <change id="ProjectHintsJava">
   10.53 +            <api name="JavaHintsSPI"/>
   10.54 +            <summary>Defining system filesystem folder for per-project Java hints customizers</summary>
   10.55 +            <version major="1" minor="16"/>
   10.56 +            <date day="24" month="4" year="2013"/>
   10.57 +            <author login="jlahoda"/>
   10.58 +            <compatibility addition="yes"/>
   10.59 +            <description>
   10.60 +                <p>
   10.61 +                    Defining <code>Project/hints/java-based</code> folder, where provider for
   10.62 +                    hints customizers for Java-based projects should be stored.
   10.63 +                </p>    
   10.64 +            </description>
   10.65 +<!--            <issue number="227959"/>-->
   10.66 +        </change>
   10.67 +        <change id="IntegerOption">
   10.68 +            <api name="JavaHintsSPI"/>
   10.69 +            <summary>Added support for integer options. Hints can be declared to appear only in inspect &amp; transform</summary>
   10.70 +            <version major="1" minor="14"/>
   10.71 +            <date day="3" month="4" year="2013"/>
   10.72 +            <author login="sdedic"/>
   10.73 +            <compatibility addition="yes"/>
   10.74 +            <description>
   10.75 +                <p>
   10.76 +                    Added declarative support for integer options. <code>@IntegerOption</code> can
   10.77 +                    be used with option name field, similar to <code>@BooleanOption</code>.
   10.78 +                </p>    
   10.79 +                <p>
   10.80 +                    An option was added to <code>Hint.Options</code>, so that hint can declare
   10.81 +                    to be only shown in Inspect &amp; transform dialog. Useful for computation-intensive
   10.82 +                    hints, which should only run on demand.
   10.83 +                </p>    
   10.84 +            </description>
   10.85 +            <class package="org.netbeans.spi.java.hints" name="IntegerOption"/>
   10.86 +            <class package="org.netbeans.spi.java.hints" name="Hint"/>
   10.87 +            <issue number="227822"/>
   10.88 +            <issue number="227959"/>
   10.89 +        </change>
   10.90 +        <change id="ErrorDescriptionFactory.forSpan">
   10.91 +            <api name="JavaHintsSPI"/>
   10.92 +            <summary>Introducing ErrorDescriptionFactory.forSpan.</summary>
   10.93 +            <version major="1" minor="9"/>
   10.94 +            <date day="19" month="12" year="2012"/>
   10.95 +            <author login="jlahoda"/>
   10.96 +            <compatibility addition="yes"/>
   10.97 +            <description>
   10.98 +                <p>
   10.99 +                    Added ErrorDescriptionFactory.forSpan to create the correct
  10.100 +                    Java-enhanced ErrorDescription from a span.
  10.101 +                </p>    
  10.102 +            </description>
  10.103 +            <class package="org.netbeans.spi.java.hints" name="ErrorDescriptionFactory"/>
  10.104 +            <issue number="223723"/>
  10.105 +        </change>
  10.106 +        <change id="TransformationSupport">
  10.107 +            <api name="JavaHintsSPI"/>
  10.108 +            <summary>Added support for using jackpot patterns from other modules (e.g. refactoring).</summary>
  10.109 +            <version major="1" minor="1"/>
  10.110 +            <date day="29" month="3" year="2012"/>
  10.111 +            <author login="jbecicka"/>
  10.112 +            <compatibility addition="yes"/>
  10.113 +            <description>
  10.114 +                <p>
  10.115 +                    Added support for using jackpot patterns from other modules (e.g. refactoring).
  10.116 +                </p>    
  10.117 +            </description>
  10.118 +            <class package="org.netbeans.spi.java.hints.support" name="TransformationSupport"/>
  10.119 +            <issue number="210262"/>
  10.120 +        </change>
  10.121 +    </changes>
  10.122 +    <htmlcontents>
  10.123 +        <head>
  10.124 +            <title>Change History for the Java Hints SPI</title>
  10.125 +            <link rel="stylesheet" href="prose.css" type="text/css"/>
  10.126 +        </head>
  10.127 +        <body>
  10.128 +            <p class="overviewlink">
  10.129 +                <a href="overview-summary.html">Overview</a>
  10.130 +            </p>
  10.131 +            <h1>Introduction</h1>
  10.132 +            <p>This document lists changes made to the Java Hints SPI.</p>
  10.133 +            
  10.134 +            <!-- The actual lists of changes, as summaries and details: -->
  10.135 +            <hr/>
  10.136 +            <standard-changelists module-code-name="$codebase"/>
  10.137 +            
  10.138 +            <hr/>
  10.139 +            <p>@FOOTER@</p>
  10.140 +        </body>
  10.141 +    </htmlcontents>
  10.142 +</apichanges>

    11.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    11.2 +++ b/java.hints/spi.java.hints/arch.xml	Wed May 08 21:47:42 2013 +0200
    11.3 @@ -0,0 +1,1115 @@
    11.4 +<?xml version="1.0" encoding="UTF-8"?>
    11.5 +<!DOCTYPE api-answers PUBLIC "-//NetBeans//DTD Arch Answers//EN" "../nbbuild/antsrc/org/netbeans/nbbuild/Arch.dtd" [
    11.6 +  <!ENTITY api-questions SYSTEM "../nbbuild/antsrc/org/netbeans/nbbuild/Arch-api-questions.xml">
    11.7 +]>
    11.8 +
    11.9 +<api-answers
   11.10 +  question-version="1.29"
   11.11 +  author="jlahoda@netbeans.org"
   11.12 +>
   11.13 +
   11.14 +  &api-questions;
   11.15 +
   11.16 +
   11.17 +<!--
   11.18 +        <question id="arch-overall" when="init">
   11.19 +            Describe the overall architecture. 
   11.20 +            <hint>
   11.21 +            What will be API for 
   11.22 +            <a href="http://openide.netbeans.org/tutorial/api-design.html#design.apiandspi">
   11.23 +                clients and what support API</a>? 
   11.24 +            What parts will be pluggable?
   11.25 +            How will plug-ins be registered? Please use <code>&lt;api type="export"/&gt;</code>
   11.26 +            to describe your general APIs and specify their
   11.27 +            <a href="http://openide.netbeans.org/tutorial/api-design.html#category-private">
   11.28 +            stability categories</a>.
   11.29 +            If possible please provide simple diagrams.
   11.30 +            </hint>
   11.31 +        </question>
   11.32 +-->
   11.33 + <answer id="arch-overall">
   11.34 +  <p>
   11.35 +   <api type="export" category="devel" group="java" name="spi.java.hints">
   11.36 +       SPI to create custom Java hints, including code smell warnings, productivity tips, etc.
   11.37 +       Please see the Use Cases section for a guide on how to use this SPI.
   11.38 +   </api>
   11.39 +  </p>
   11.40 + </answer>
   11.41 +
   11.42 +
   11.43 +
   11.44 +<!--
   11.45 +        <question id="arch-quality" when="init">
   11.46 +            How will the <a href="http://www.netbeans.org/community/guidelines/q-evangelism.html">quality</a>
   11.47 +            of your code be tested and 
   11.48 +            how are future regressions going to be prevented?
   11.49 +            <hint>
   11.50 +            What kind of testing do
   11.51 +            you want to use? How much functionality, in which areas,
   11.52 +            should be covered by the tests? How you find out that your
   11.53 +            project was successful?
   11.54 +            </hint>
   11.55 +        </question>
   11.56 +-->
   11.57 + <answer id="arch-quality">
   11.58 +  <p>
   11.59 +   XXX no answer for arch-quality
   11.60 +  </p>
   11.61 + </answer>
   11.62 +
   11.63 +
   11.64 +
   11.65 +<!--
   11.66 +        <question id="arch-time" when="init">
   11.67 +            What are the time estimates of the work?
   11.68 +            <hint>
   11.69 +            Please express your estimates of how long the design, implementation,
   11.70 +            stabilization are likely to last. How many people will be needed to
   11.71 +            implement this and what is the expected milestone by which the work should be 
   11.72 +            ready?
   11.73 +            </hint>
   11.74 +        </question>
   11.75 +-->
   11.76 + <answer id="arch-time">
   11.77 +  <p>
   11.78 +   XXX no answer for arch-time
   11.79 +  </p>
   11.80 + </answer>
   11.81 +
   11.82 +
   11.83 +
   11.84 +<!--
   11.85 +        <question id="arch-usecases" when="init">
   11.86 +            <hint>
   11.87 +                Content of this answer will be displayed as part of page at
   11.88 +                http://www.netbeans.org/download/dev/javadoc/usecases.html 
   11.89 +                You can use tags &lt;usecase name="name&gt; regular html description &lt;/usecase&gt;
   11.90 +                and if you want to use an URL you can prefix if with @TOP@ to begin
   11.91 +                at the root of your javadoc
   11.92 +            </hint>
   11.93 +        
   11.94 +            Describe the main <a href="http://openide.netbeans.org/tutorial/api-design.html#usecase">
   11.95 +            use cases</a> of the new API. Who will use it under
   11.96 +            what circumstances? What kind of code would typically need to be written
   11.97 +            to use the module?
   11.98 +        </question>
   11.99 +-->
  11.100 + <answer id="arch-usecases">
  11.101 +  <p>
  11.102 +   <usecase id="creating" name="Creating a new Java Hint">
  11.103 +       Simple way to create a new Java hint is as follows:
  11.104 +       <ul>
  11.105 +           <li>Create a new class, annotate it with the <a href="@TOP@/org/netbeans/spi/java/hints/Hint.html">@Hint</a>
  11.106 +           annotation to it.</li>
  11.107 +           <li>Create a <code>public static ErrorDescription hint(HintContext ctx) {}</code> method in the
  11.108 +           class. Annotate the method either with the <a href="@TOP@/org/netbeans/spi/java/hints/TriggerPattern.html">@TriggerPattern</a>
  11.109 +           annotation (strongly recommended), or with the <a href="@TOP@/org/netbeans/spi/java/hints/TriggerTreeKind.html">@TriggerTreeKind</a>.
  11.110 +           This method will be called when for parts of the code that match the given pattern, of for trees of the specified kinds.</li>
  11.111 +           <li>Perform whatever checks necessary to find out whether a warning should be produced at the given place, and produce the ErrorDescription if needed.</li>
  11.112 +       </ul>
  11.113 +       <br/>
  11.114 +       Tips:
  11.115 +       <ul>
  11.116 +           <li>Always use the java.hints' <a href="@TOP@/org/netbeans/spi/java/hints/ErrorDescriptionFactory.html">ErrorDescriptionFactory</a> to produce the resulting ErrorDescription.</li>
  11.117 +           <li>Never try to produce a custom suppress warnings "fix". Specify suppress warnings keys in the @Hint annotation.</li>
  11.118 +           <li>If an automated transformation is to be prodived from your hint, subclass <a href="@TOP@/org/netbeans/spi/java/hints/JavaFix.html">JavaFix</a> and
  11.119 +               use its <code>toEditorFix()</code> method to get the <code>Fix</code>, if the transformation is going to be used inside Inspect&amp;Transform.
  11.120 +           </li>
  11.121 +           <li>The name of the method is arbitrary, one hint can consist of more that one "triggered" method.</li>
  11.122 +       </ul>
  11.123 +   </usecase>
  11.124 +   <usecase id="no-class" name="Creating a new Java Hint Without a Class">
  11.125 +       For simple hints, it is possible to annotate the hint method with the <a href="@TOP@/org/netbeans/spi/java/hints/Hint.html">@Hint</a> annotation.
  11.126 +       The hint then consists of this sole method. Any number of such hints may be created in a single class.
  11.127 +   </usecase>
  11.128 +   <usecase id="testing" name="Creating a Tests for the Newly Created Java Hint">
  11.129 +       Creating automated tests for the hints is simple: create a test class, and use
  11.130 +       <a href="@TOP@/../org-netbeans-modules-java-hints-test/org/netbeans/modules/java/hints/test/api/HintTest.html">HintTest</a>
  11.131 +       to setup the test, run the hint and verify that its outcomes are correct.
  11.132 +       The tests automatically run with <code>test</code> branding, so create <code>Bundle_test.properties</code>, and add
  11.133 +       bundle keys into it for ErrorDescription and Fix display names, to isolate the test from changes in the production
  11.134 +       <code>Bundle.properties</code>.
  11.135 +   </usecase>
  11.136 +   <usecase id="adding-options" name="Adding options to a Java Hint">
  11.137 +       To add a simple boolean option to your hint, use <a href="@TOP@/org/netbeans/spi/java/hints/BooleanOption.html">@BooleanOption</a>.
  11.138 +   </usecase>
  11.139 +  </p>
  11.140 + </answer>
  11.141 +
  11.142 +
  11.143 +
  11.144 +<!--
  11.145 +        <question id="arch-what" when="init">
  11.146 +            What is this project good for?
  11.147 +            <hint>
  11.148 +            Please provide here a few lines describing the project, 
  11.149 +            what problem it should solve, provide links to documentation, 
  11.150 +            specifications, etc.
  11.151 +            </hint>
  11.152 +        </question>
  11.153 +-->
  11.154 + <answer id="arch-what">
  11.155 +  <p>
  11.156 +   XXX no answer for arch-what
  11.157 +  </p>
  11.158 + </answer>
  11.159 +
  11.160 +
  11.161 +
  11.162 +<!--
  11.163 +        <question id="arch-where" when="impl">
  11.164 +            Where one can find sources for your module?
  11.165 +            <hint>
  11.166 +                Please provide link to the Hg web client at
  11.167 +                http://hg.netbeans.org/
  11.168 +                or just use tag defaultanswer generate='here'
  11.169 +            </hint>
  11.170 +        </question>
  11.171 +-->
  11.172 + <answer id="arch-where">
  11.173 +  <defaultanswer generate='here' />
  11.174 + </answer>
  11.175 +
  11.176 +
  11.177 +
  11.178 +<!--
  11.179 +        <question id="compat-deprecation" when="init">
  11.180 +            How the introduction of your project influences functionality
  11.181 +            provided by previous version of the product?
  11.182 +            <hint>
  11.183 +            If you are planning to deprecate/remove/change any existing APIs,
  11.184 +            list them here accompanied with the reason explaining why you
  11.185 +            are doing so.
  11.186 +            </hint>
  11.187 +        </question>
  11.188 +-->
  11.189 + <answer id="compat-deprecation">
  11.190 +  <p>
  11.191 +   XXX no answer for compat-deprecation
  11.192 +  </p>
  11.193 + </answer>
  11.194 +
  11.195 +
  11.196 +
  11.197 +<!--
  11.198 +        <question id="compat-i18n" when="impl">
  11.199 +            Is your module correctly internationalized?
  11.200 +            <hint>
  11.201 +            Correct internationalization means that it obeys instructions 
  11.202 +            at <a href="http://www.netbeans.org/download/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/i18n-branding.html">
  11.203 +            NetBeans I18N pages</a>.
  11.204 +            </hint>
  11.205 +        </question>
  11.206 +-->
  11.207 + <answer id="compat-i18n">
  11.208 +  <p>
  11.209 +   XXX no answer for compat-i18n
  11.210 +  </p>
  11.211 + </answer>
  11.212 +
  11.213 +
  11.214 +
  11.215 +<!--
  11.216 +        <question id="compat-standards" when="init">
  11.217 +            Does the module implement or define any standards? Is the 
  11.218 +            implementation exact or does it deviate somehow?
  11.219 +        </question>
  11.220 +-->
  11.221 + <answer id="compat-standards">
  11.222 +  <p>
  11.223 +   XXX no answer for compat-standards
  11.224 +  </p>
  11.225 + </answer>
  11.226 +
  11.227 +
  11.228 +
  11.229 +<!--
  11.230 +        <question id="compat-version" when="impl">
  11.231 +            Can your module coexist with earlier and future
  11.232 +            versions of itself? Can you correctly read all old settings? Will future
  11.233 +            versions be able to read your current settings? Can you read
  11.234 +            or politely ignore settings stored by a future version?
  11.235 +            
  11.236 +            <hint>
  11.237 +            Very helpful for reading settings is to store version number
  11.238 +            there, so future versions can decide whether how to read/convert
  11.239 +            the settings and older versions can ignore the new ones.
  11.240 +            </hint>
  11.241 +        </question>
  11.242 +-->
  11.243 + <answer id="compat-version">
  11.244 +  <p>
  11.245 +   XXX no answer for compat-version
  11.246 +  </p>
  11.247 + </answer>
  11.248 +
  11.249 +
  11.250 +
  11.251 +<!--
  11.252 +        <question id="dep-jre" when="final">
  11.253 +            Which version of JRE do you need (1.2, 1.3, 1.4, etc.)?
  11.254 +            <hint>
  11.255 +            It is expected that if your module runs on 1.x that it will run 
  11.256 +            on 1.x+1 if no, state that please. Also describe here cases where
  11.257 +            you run different code on different versions of JRE and why.
  11.258 +            </hint>
  11.259 +        </question>
  11.260 +-->
  11.261 + <answer id="dep-jre">
  11.262 +  <p>
  11.263 +   XXX no answer for dep-jre
  11.264 +  </p>
  11.265 + </answer>
  11.266 +
  11.267 +
  11.268 +
  11.269 +<!--
  11.270 +        <question id="dep-jrejdk" when="final">
  11.271 +            Do you require the JDK or is the JRE enough?
  11.272 +        </question>
  11.273 +-->
  11.274 + <answer id="dep-jrejdk">
  11.275 +  <p>
  11.276 +   XXX no answer for dep-jrejdk
  11.277 +  </p>
  11.278 + </answer>
  11.279 +
  11.280 +
  11.281 +
  11.282 +<!--
  11.283 +        <question id="dep-nb" when="init">
  11.284 +            What other NetBeans projects and modules does this one depend on?
  11.285 +            <hint>
  11.286 +            Depending on other NetBeans projects influnces the ability of
  11.287 +            users of your work to customize their own branded version of
  11.288 +            NetBeans by enabling and disabling some modules. Too
  11.289 +            much dependencies restrict this kind of customization. If that
  11.290 +            is your case, then you may want to split your functionality into
  11.291 +            pieces of autoload, eager and regular modules which can be
  11.292 +            enabled independently. Usually the answer to this question
  11.293 +            is generated from your <code>project.xml</code> file, but
  11.294 +            if it is not guessed correctly, you can suppress it by
  11.295 +            specifying &lt;defaultanswer generate="none"/&gt; and
  11.296 +            write here your own. Please describe such projects as imported APIs using
  11.297 +            the <code>&lt;api name="identification" type="import or export" category="stable" url="where is the description" /&gt;</code>.
  11.298 +            By doing this information gets listed in the summary page of your
  11.299 +            javadoc.
  11.300 +            </hint>
  11.301 +        </question>
  11.302 +-->
  11.303 + <answer id="dep-nb">
  11.304 +  <defaultanswer generate='here' />
  11.305 + </answer>
  11.306 +
  11.307 +
  11.308 +
  11.309 +<!--
  11.310 +        <question id="dep-non-nb" when="init">
  11.311 +            What other projects outside NetBeans does this one depend on?
  11.312 +            
  11.313 +            <hint>
  11.314 +            Depending on 3rd party libraries is always problematic,
  11.315 +            especially if they are not open source, as that complicates
  11.316 +            the licensing scheme of NetBeans. Please enumerate your
  11.317 +            external dependencies here, so it is correctly understood since
  11.318 +            the begining what are the legal implications of your project.
  11.319 +            Also please note that
  11.320 +            some non-NetBeans projects are packaged as NetBeans modules
  11.321 +            (see <a href="http://libs.netbeans.org/">libraries</a>) and
  11.322 +            it is preferred to use this approach when more modules may
  11.323 +            depend and share such third-party libraries.
  11.324 +            </hint>
  11.325 +        </question>
  11.326 +-->
  11.327 + <answer id="dep-non-nb">
  11.328 +  <p>
  11.329 +   XXX no answer for dep-non-nb
  11.330 +  </p>
  11.331 + </answer>
  11.332 +
  11.333 +
  11.334 +
  11.335 +<!--
  11.336 +        <question id="dep-platform" when="init">
  11.337 +            On which platforms does your module run? Does it run in the same
  11.338 +            way on each?
  11.339 +            <hint>
  11.340 +            If you plan any dependency on OS or any usage of native code,
  11.341 +            please describe why you are doing so and describe how you envision
  11.342 +            to enforce the portability of your code.
  11.343 +            Please note that there is a support for <a href="http://www.netbeans.org/download/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/api.html#how-os-specific">OS conditionally
  11.344 +            enabled modules</a> which together with autoload/eager modules
  11.345 +            can allow you to enable to provide the best OS aware support
  11.346 +            on certain OSes while providing compatibility bridge on the not
  11.347 +            supported ones.
  11.348 +            Also please list the supported
  11.349 +            OSes/HW platforms and mentioned the lovest version of JDK required
  11.350 +            for your project to run on. Also state whether JRE is enough or
  11.351 +            you really need JDK.
  11.352 +            </hint>
  11.353 +        </question>
  11.354 +-->
  11.355 + <answer id="dep-platform">
  11.356 +  <p>
  11.357 +   XXX no answer for dep-platform
  11.358 +  </p>
  11.359 + </answer>
  11.360 +
  11.361 +
  11.362 +
  11.363 +<!--
  11.364 +        <question id="deploy-dependencies" when="final">
  11.365 +            What do other modules need to do to declare a dependency on this one,
  11.366 +            in addition to or instead of the normal module dependency declaration
  11.367 +            (e.g. tokens to require)?
  11.368 +            <hint>
  11.369 +                Provide a sample of the actual lines you would add to a module manifest
  11.370 +                to declare a dependency, for example OpenIDE-Module-Requires: some.token.
  11.371 +                If other modules should not depend on this module, or should just use a
  11.372 +                simple regular module dependency, you can just answer "nothing". If you
  11.373 +                intentionally expose a semistable API to clients using implementation
  11.374 +                dependencies, you should mention that here (but there is no need to give
  11.375 +                an example of usage).
  11.376 +            </hint>
  11.377 +        </question>
  11.378 +-->
  11.379 + <answer id="deploy-dependencies">
  11.380 +  <p>
  11.381 +   XXX no answer for deploy-dependencies
  11.382 +  </p>
  11.383 + </answer>
  11.384 +
  11.385 +
  11.386 +
  11.387 +<!--
  11.388 +        <question id="deploy-jar" when="impl">
  11.389 +            Do you deploy just module JAR file(s) or other files as well?
  11.390 +            <hint>
  11.391 +            Usually a module consist of one JAR file (perhaps with Class-Path
  11.392 +            extensions) and also a configuration file that enables it. If you
  11.393 +            have any other files, use
  11.394 +            &lt;api group="java.io.File" name="yourname" type="export" category="friend"&gt;...&lt;/api&gt;
  11.395 +            to define the location, name and stability of your files (of course
  11.396 +            changing "yourname" and "friend" to suit your needs).
  11.397 +            
  11.398 +            If it uses more than one JAR, describe where they are located, how
  11.399 +            they refer to each other. 
  11.400 +            If it consist of module JAR(s) and other files, please describe
  11.401 +            what is their purpose, why other files are necessary. Please 
  11.402 +            make sure that installation/uninstallation leaves the system 
  11.403 +            in state as it was before installation.
  11.404 +            </hint>
  11.405 +        </question>
  11.406 +-->
  11.407 + <answer id="deploy-jar">
  11.408 +  <p>
  11.409 +   XXX no answer for deploy-jar
  11.410 +  </p>
  11.411 + </answer>
  11.412 +
  11.413 +
  11.414 +
  11.415 +<!--
  11.416 +        <question id="deploy-nbm" when="impl">
  11.417 +            Can you deploy an NBM via the Update Center?
  11.418 +            <hint>
  11.419 +            If not why?
  11.420 +            </hint>
  11.421 +        </question>
  11.422 +-->
  11.423 + <answer id="deploy-nbm">
  11.424 +  <p>
  11.425 +   XXX no answer for deploy-nbm
  11.426 +  </p>
  11.427 + </answer>
  11.428 +
  11.429 +
  11.430 +
  11.431 +<!--
  11.432 +        <question id="deploy-packages" when="init">
  11.433 +            Are packages of your module made inaccessible by not declaring them
  11.434 +            public?
  11.435 +            
  11.436 +            <hint>
  11.437 +            By default NetBeans build harness treats all packages are private.
  11.438 +            If you export some of them - either as public or friend packages,
  11.439 +            you should have a reason. If the reason is described elsewhere
  11.440 +            in this document, you can ignore this question.
  11.441 +            </hint>
  11.442 +        </question>
  11.443 +-->
  11.444 + <answer id="deploy-packages">
  11.445 +  <p>
  11.446 +   XXX no answer for deploy-packages
  11.447 +  </p>
  11.448 + </answer>
  11.449 +
  11.450 +
  11.451 +
  11.452 +<!--
  11.453 +        <question id="deploy-shared" when="final">
  11.454 +            Do you need to be installed in the shared location only, or in the user directory only,
  11.455 +            or can your module be installed anywhere?
  11.456 +            <hint>
  11.457 +            Installation location shall not matter, if it does explain why.
  11.458 +            Consider also whether <code>InstalledFileLocator</code> can help.
  11.459 +            </hint>
  11.460 +        </question>
  11.461 +-->
  11.462 + <answer id="deploy-shared">
  11.463 +  <p>
  11.464 +   XXX no answer for deploy-shared
  11.465 +  </p>
  11.466 + </answer>
  11.467 +
  11.468 +
  11.469 +
  11.470 +<!--
  11.471 +        <question id="exec-ant-tasks" when="impl">
  11.472 +            Do you define or register any ant tasks that other can use?
  11.473 +            
  11.474 +            <hint>
  11.475 +            If you provide an ant task that users can use, you need to be very
  11.476 +            careful about its syntax and behaviour, as it most likely forms an
  11.477 +	          API for end users and as there is a lot of end users, their reaction
  11.478 +            when such API gets broken can be pretty strong.
  11.479 +            </hint>
  11.480 +        </question>
  11.481 +-->
  11.482 + <answer id="exec-ant-tasks">
  11.483 +  <p>
  11.484 +   XXX no answer for exec-ant-tasks
  11.485 +  </p>
  11.486 + </answer>
  11.487 +
  11.488 +
  11.489 +
  11.490 +<!--
  11.491 +        <question id="exec-classloader" when="impl">
  11.492 +            Does your code create its own class loader(s)?
  11.493 +            <hint>
  11.494 +            A bit unusual. Please explain why and what for.
  11.495 +            </hint>
  11.496 +        </question>
  11.497 +-->
  11.498 + <answer id="exec-classloader">
  11.499 +  <p>
  11.500 +   XXX no answer for exec-classloader
  11.501 +  </p>
  11.502 + </answer>
  11.503 +
  11.504 +
  11.505 +
  11.506 +<!--
  11.507 +        <question id="exec-component" when="impl">
  11.508 +            Is execution of your code influenced by any (string) property
  11.509 +            of any of your components?
  11.510 +            
  11.511 +            <hint>
  11.512 +            Often <code>JComponent.getClientProperty</code>, <code>Action.getValue</code>
  11.513 +            or <code>PropertyDescriptor.getValue</code>, etc. are used to influence
  11.514 +            a behavior of some code. This of course forms an interface that should
  11.515 +            be documented. Also if one depends on some interface that an object
  11.516 +            implements (<code>component instanceof Runnable</code>) that forms an
  11.517 +            API as well.
  11.518 +            </hint>
  11.519 +        </question>
  11.520 +-->
  11.521 + <answer id="exec-component">
  11.522 +  <p>
  11.523 +   XXX no answer for exec-component
  11.524 +  </p>
  11.525 + </answer>
  11.526 +
  11.527 +
  11.528 +
  11.529 +<!--
  11.530 +        <question id="exec-introspection" when="impl">
  11.531 +            Does your module use any kind of runtime type information (<code>instanceof</code>,
  11.532 +            work with <code>java.lang.Class</code>, etc.)?
  11.533 +            <hint>
  11.534 +            Check for cases when you have an object of type A and you also
  11.535 +            expect it to (possibly) be of type B and do some special action. That
  11.536 +            should be documented. The same applies on operations in meta-level
  11.537 +            (Class.isInstance(...), Class.isAssignableFrom(...), etc.).
  11.538 +            </hint>
  11.539 +        </question>
  11.540 +-->
  11.541 + <answer id="exec-introspection">
  11.542 +  <p>
  11.543 +   XXX no answer for exec-introspection
  11.544 +  </p>
  11.545 + </answer>
  11.546 +
  11.547 +
  11.548 +
  11.549 +<!--
  11.550 +        <question id="exec-privateaccess" when="final">
  11.551 +            Are you aware of any other parts of the system calling some of 
  11.552 +            your methods by reflection?
  11.553 +            <hint>
  11.554 +            If so, describe the "contract" as an API. Likely private or friend one, but
  11.555 +            still API and consider rewrite of it.
  11.556 +            </hint>
  11.557 +        </question>
  11.558 +-->
  11.559 + <answer id="exec-privateaccess">
  11.560 +  <p>
  11.561 +   XXX no answer for exec-privateaccess
  11.562 +  </p>
  11.563 + </answer>
  11.564 +
  11.565 +
  11.566 +
  11.567 +<!--
  11.568 +        <question id="exec-process" when="impl">
  11.569 +            Do you execute an external process from your module? How do you ensure
  11.570 +            that the result is the same on different platforms? Do you parse output?
  11.571 +            Do you depend on result code?
  11.572 +            <hint>
  11.573 +            If you feed an input, parse the output please declare that as an API.
  11.574 +            </hint>
  11.575 +        </question>
  11.576 +-->
  11.577 + <answer id="exec-process">
  11.578 +  <p>
  11.579 +   XXX no answer for exec-process
  11.580 +  </p>
  11.581 + </answer>
  11.582 +
  11.583 +
  11.584 +
  11.585 +<!--
  11.586 +        <question id="exec-property" when="impl">
  11.587 +            Is execution of your code influenced by any environment or
  11.588 +            Java system (<code>System.getProperty</code>) property?
  11.589 +            On a similar note, is there something interesting that you
  11.590 +            pass to <code>java.util.logging.Logger</code>? Or do you observe
  11.591 +            what others log?
  11.592 +            <hint>
  11.593 +            If there is a property that can change the behavior of your 
  11.594 +            code, somebody will likely use it. You should describe what it does 
  11.595 +            and the <a href="http://openide.netbeans.org/tutorial/api-design.html#life">stability category</a>
  11.596 +            of this API. You may use
  11.597 +            <pre>
  11.598 +                &lt;api type="export" group="property" name="id" category="private" url="http://..."&gt;
  11.599 +                    description of the property, where it is used, what it influence, etc.
  11.600 +                &lt;/api&gt;            
  11.601 +            </pre>
  11.602 +            </hint>
  11.603 +        </question>
  11.604 +-->
  11.605 + <answer id="exec-property">
  11.606 +  <p>
  11.607 +   XXX no answer for exec-property
  11.608 +  </p>
  11.609 + </answer>
  11.610 +
  11.611 +
  11.612 +
  11.613 +<!--
  11.614 +        <question id="exec-reflection" when="impl">
  11.615 +            Does your code use Java Reflection to execute other code?
  11.616 +            <hint>
  11.617 +            This usually indicates a missing or insufficient API in the other
  11.618 +            part of the system. If the other side is not aware of your dependency
  11.619 +            this contract can be easily broken.
  11.620 +            </hint>
  11.621 +        </question>
  11.622 +-->
  11.623 + <answer id="exec-reflection">
  11.624 +  <p>
  11.625 +   XXX no answer for exec-reflection
  11.626 +  </p>
  11.627 + </answer>
  11.628 +
  11.629 +
  11.630 +
  11.631 +<!--
  11.632 +        <question id="exec-threading" when="init">
  11.633 +            What threading models, if any, does your module adhere to? How the
  11.634 +            project behaves with respect to threading?
  11.635 +            <hint>
  11.636 +                Is your API threadsafe? Can it be accessed from any threads or
  11.637 +                just from some dedicated ones? Any special relation to AWT and
  11.638 +                its Event Dispatch thread? Also
  11.639 +                if your module calls foreign APIs which have a specific threading model,
  11.640 +                indicate how you comply with the requirements for multithreaded access
  11.641 +                (synchronization, mutexes, etc.) applicable to those APIs.
  11.642 +                If your module defines any APIs, or has complex internal structures
  11.643 +                that might be used from multiple threads, declare how you protect
  11.644 +                data against concurrent access, race conditions, deadlocks, etc.,
  11.645 +                and whether such rules are enforced by runtime warnings, errors, assertions, etc.
  11.646 +                Examples: a class might be non-thread-safe (like Java Collections); might
  11.647 +                be fully thread-safe (internal locking); might require access through a mutex
  11.648 +                (and may or may not automatically acquire that mutex on behalf of a client method);
  11.649 +                might be able to run only in the event queue; etc.
  11.650 +                Also describe when any events are fired: synchronously, asynchronously, etc.
  11.651 +                Ideas: <a href="http://core.netbeans.org/proposals/threading/index.html#recommendations">Threading Recommendations</a> (in progress)
  11.652 +            </hint>
  11.653 +        </question>
  11.654 +-->
  11.655 + <answer id="exec-threading">
  11.656 +  <p>
  11.657 +   XXX no answer for exec-threading
  11.658 +  </p>
  11.659 + </answer>
  11.660 +
  11.661 +
  11.662 +
  11.663 +<!--
  11.664 +        <question id="format-clipboard" when="impl">
  11.665 +            Which data flavors (if any) does your code read from or insert to
  11.666 +            the clipboard (by access to clipboard on means calling methods on <code>java.awt.datatransfer.Transferable</code>?
  11.667 +            
  11.668 +            <hint>
  11.669 +            Often Node's deal with clipboard by usage of <code>Node.clipboardCopy, Node.clipboardCut and Node.pasteTypes</code>.
  11.670 +            Check your code for overriding these methods.
  11.671 +            </hint>
  11.672 +        </question>
  11.673 +-->
  11.674 + <answer id="format-clipboard">
  11.675 +  <p>
  11.676 +   XXX no answer for format-clipboard
  11.677 +  </p>
  11.678 + </answer>
  11.679 +
  11.680 +
  11.681 +
  11.682 +<!--
  11.683 +        <question id="format-dnd" when="impl">
  11.684 +            Which protocols (if any) does your code understand during Drag &amp; Drop?
  11.685 +            <hint>
  11.686 +            Often Node's deal with clipboard by usage of <code>Node.drag, Node.getDropType</code>. 
  11.687 +            Check your code for overriding these methods. Btw. if they are not overridden, they
  11.688 +            by default delegate to <code>Node.clipboardCopy, Node.clipboardCut and Node.pasteTypes</code>.
  11.689 +            </hint>
  11.690 +        </question>
  11.691 +-->
  11.692 + <answer id="format-dnd">
  11.693 +  <p>
  11.694 +   XXX no answer for format-dnd
  11.695 +  </p>
  11.696 + </answer>
  11.697 +
  11.698 +
  11.699 +
  11.700 +<!--
  11.701 +        <question id="format-types" when="impl">
  11.702 +            Which protocols and file formats (if any) does your module read or write on disk,
  11.703 +            or transmit or receive over the network? Do you generate an ant build script?
  11.704 +            Can it be edited and modified? 
  11.705 +            
  11.706 +            <hint>
  11.707 +            <p>
  11.708 +            Files can be read and written by other programs, modules and users. If they influence
  11.709 +            your behaviour, make sure you either document the format or claim that it is a private
  11.710 +            api (using the &lt;api&gt; tag). 
  11.711 +            </p>
  11.712 +            
  11.713 +            <p>
  11.714 +            If you generate an ant build file, this is very likely going to be seen by end users and
  11.715 +            they will be attempted to edit it. You should be ready for that and provide here a link
  11.716 +            to documentation that you have for such purposes and also describe how you are going to
  11.717 +            understand such files during next release, when you (very likely) slightly change the 
  11.718 +            format.
  11.719 +            </p>
  11.720 +            </hint>
  11.721 +        </question>
  11.722 +-->
  11.723 + <answer id="format-types">
  11.724 +  <p>
  11.725 +   XXX no answer for format-types
  11.726 +  </p>
  11.727 + </answer>
  11.728 +
  11.729 +
  11.730 +
  11.731 +<!--
  11.732 +        <question id="lookup-lookup" when="init">
  11.733 +            Does your module use <code>org.openide.util.Lookup</code>
  11.734 +            or any similar technology to find any components to communicate with? Which ones?
  11.735 +            
  11.736 +            <hint>
  11.737 +            NetBeans is build around a generic registry of services called
  11.738 +            lookup. It is preferable to use it for registration and discovery
  11.739 +            if possible. See
  11.740 +            <a href="http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/lookup/doc-files/index.html">
  11.741 +            The Solution to Comunication Between Components
  11.742 +            </a>. If you do not plan to use lookup and insist usage
  11.743 +            of other solution, then please describe why it is not working for
  11.744 +            you.
  11.745 +            <br/>
  11.746 +            When filling the final version of your arch document, please
  11.747 +            describe the interfaces you are searching for, where 
  11.748 +            are defined, whether you are searching for just one or more of them,
  11.749 +            if the order is important, etc. Also classify the stability of such
  11.750 +            API contract. Use &lt;api group=&amp;lookup&amp; /&gt; tag, so
  11.751 +            your information gets listed in the summary page of your javadoc.
  11.752 +            </hint>
  11.753 +        </question>
  11.754 +-->
  11.755 + <answer id="lookup-lookup">
  11.756 +  <p>
  11.757 +   XXX no answer for lookup-lookup
  11.758 +  </p>
  11.759 + </answer>
  11.760 +
  11.761 +
  11.762 +
  11.763 +<!--
  11.764 +        <question id="lookup-register" when="final">
  11.765 +            Do you register anything into lookup for other code to find?
  11.766 +            <hint>
  11.767 +            Do you register using layer file or using a declarative annotation such as <code>@ServiceProvider</code>?
  11.768 +            Who is supposed to find your component?
  11.769 +            </hint>
  11.770 +        </question>
  11.771 +-->
  11.772 + <answer id="lookup-register">
  11.773 +  <p>
  11.774 +   XXX no answer for lookup-register
  11.775 +  </p>
  11.776 + </answer>
  11.777 +
  11.778 +
  11.779 +
  11.780 +<!--
  11.781 +        <question id="lookup-remove" when="final">
  11.782 +            Do you remove entries of other modules from lookup?
  11.783 +            <hint>
  11.784 +            Why? Of course, that is possible, but it can be dangerous. Is the module
  11.785 +            your are masking resource from aware of what you are doing?
  11.786 +            </hint>
  11.787 +        </question>
  11.788 +-->
  11.789 + <answer id="lookup-remove">
  11.790 +  <p>
  11.791 +   XXX no answer for lookup-remove
  11.792 +  </p>
  11.793 + </answer>
  11.794 +
  11.795 +
  11.796 +
  11.797 +<!--
  11.798 +        <question id="perf-exit" when="final">
  11.799 +            Does your module run any code on exit?
  11.800 +        </question>
  11.801 +-->
  11.802 + <answer id="perf-exit">
  11.803 +  <p>
  11.804 +   XXX no answer for perf-exit
  11.805 +  </p>
  11.806 + </answer>
  11.807 +
  11.808 +
  11.809 +
  11.810 +<!--
  11.811 +        <question id="perf-huge_dialogs" when="final">
  11.812 +            Does your module contain any dialogs or wizards with a large number of
  11.813 +            GUI controls such as combo boxes, lists, trees, or text areas?
  11.814 +        </question>
  11.815 +-->
  11.816 + <answer id="perf-huge_dialogs">
  11.817 +  <p>
  11.818 +   XXX no answer for perf-huge_dialogs
  11.819 +  </p>
  11.820 + </answer>
  11.821 +
  11.822 +
  11.823 +
  11.824 +<!--
  11.825 +        <question id="perf-limit" when="init">
  11.826 +            Are there any hard-coded or practical limits in the number or size of
  11.827 +            elements your code can handle?
  11.828 +            <hint>
  11.829 +                Most of algorithms have increasing memory and speed complexity
  11.830 +                with respect to size of data they operate on. What is the critical
  11.831 +                part of your project that can be seen as a bottleneck with
  11.832 +                respect to speed or required memory? What are the practical
  11.833 +                sizes of data you tested your project with? What is your estimate
  11.834 +                of potential size of data that would cause visible performance
  11.835 +                problems? Is there some kind of check to detect such situation
  11.836 +                and prevent "hard" crashes - for example the CloneableEditorSupport
  11.837 +                checks for size of a file to be opened in editor
  11.838 +                and if it is larger than 1Mb it shows a dialog giving the
  11.839 +                user the right to decide - e.g. to cancel or commit suicide.
  11.840 +            </hint>
  11.841 +        </question>
  11.842 +-->
  11.843 + <answer id="perf-limit">
  11.844 +  <p>
  11.845 +   XXX no answer for perf-limit
  11.846 +  </p>
  11.847 + </answer>
  11.848 +
  11.849 +
  11.850 +
  11.851 +<!--
  11.852 +        <question id="perf-mem" when="final">
  11.853 +            How much memory does your component consume? Estimate
  11.854 +            with a relation to the number of windows, etc.
  11.855 +        </question>
  11.856 +-->
  11.857 + <answer id="perf-mem">
  11.858 +  <p>
  11.859 +   XXX no answer for perf-mem
  11.860 +  </p>
  11.861 + </answer>
  11.862 +
  11.863 +
  11.864 +
  11.865 +<!--
  11.866 +        <question id="perf-menus" when="final">
  11.867 +            Does your module use dynamically updated context menus, or
  11.868 +            context-sensitive actions with complicated and slow enablement logic?
  11.869 +            <hint>
  11.870 +                If you do a lot of tricks when adding actions to regular or context menus, you can significantly
  11.871 +                slow down display of the menu, even when the user is not using your action. Pay attention to
  11.872 +                actions you add to the main menu bar, and to context menus of foreign nodes or components. If
  11.873 +                the action is conditionally enabled, or changes its display dynamically, you need to check the
  11.874 +                impact on performance. In some cases it may be more appropriate to make a simple action that is
  11.875 +                always enabled but does more detailed checks in a dialog if it is actually run.
  11.876 +            </hint>
  11.877 +        </question>
  11.878 +-->
  11.879 + <answer id="perf-menus">
  11.880 +  <p>
  11.881 +   XXX no answer for perf-menus
  11.882 +  </p>
  11.883 + </answer>
  11.884 +
  11.885 +
  11.886 +
  11.887 +<!--
  11.888 +        <question id="perf-progress" when="final">
  11.889 +            Does your module execute any long-running tasks?
  11.890 +            
  11.891 +            <hint>Long running tasks should never block 
  11.892 +            AWT thread as it badly hurts the UI
  11.893 +            <a href="http://performance.netbeans.org/responsiveness/issues.html">
  11.894 +            responsiveness</a>.
  11.895 +            Tasks like connecting over
  11.896 +            network, computing huge amount of data, compilation
  11.897 +            be done asynchronously (for example
  11.898 +            using <code>RequestProcessor</code>), definitively it should 
  11.899 +            not block AWT thread.
  11.900 +            </hint>
  11.901 +        </question>
  11.902 +-->
  11.903 + <answer id="perf-progress">
  11.904 +  <p>
  11.905 +   XXX no answer for perf-progress
  11.906 +  </p>
  11.907 + </answer>
  11.908 +
  11.909 +
  11.910 +
  11.911 +<!--
  11.912 +        <question id="perf-scale" when="init">
  11.913 +            Which external criteria influence the performance of your
  11.914 +            program (size of file in editor, number of files in menu, 
  11.915 +            in source directory, etc.) and how well your code scales?
  11.916 +            <hint>
  11.917 +            Please include some estimates, there are other more detailed 
  11.918 +            questions to answer in later phases of implementation. 
  11.919 +            </hint>
  11.920 +        </question>
  11.921 +-->
  11.922 + <answer id="perf-scale">
  11.923 +  <p>
  11.924 +   XXX no answer for perf-scale
  11.925 +  </p>
  11.926 + </answer>
  11.927 +
  11.928 +
  11.929 +
  11.930 +<!--
  11.931 +        <question id="perf-spi" when="init">
  11.932 +            How the performance of the plugged in code will be enforced?
  11.933 +            <hint>
  11.934 +            If you allow foreign code to be plugged into your own module, how
  11.935 +            do you enforce that it will behave correctly and quickly and will not
  11.936 +            negatively influence the performance of your own module?
  11.937 +            </hint>
  11.938 +        </question>
  11.939 +-->
  11.940 + <answer id="perf-spi">
  11.941 +  <p>
  11.942 +   XXX no answer for perf-spi
  11.943 +  </p>
  11.944 + </answer>
  11.945 +
  11.946 +
  11.947 +
  11.948 +<!--
  11.949 +        <question id="perf-startup" when="final">
  11.950 +            Does your module run any code on startup?
  11.951 +        </question>
  11.952 +-->
  11.953 + <answer id="perf-startup">
  11.954 +  <p>
  11.955 +   XXX no answer for perf-startup
  11.956 +  </p>
  11.957 + </answer>
  11.958 +
  11.959 +
  11.960 +
  11.961 +<!--
  11.962 +        <question id="perf-wakeup" when="final">
  11.963 +            Does any piece of your code wake up periodically and do something
  11.964 +            even when the system is otherwise idle (no user interaction)?
  11.965 +        </question>
  11.966 +-->
  11.967 + <answer id="perf-wakeup">
  11.968 +  <p>
  11.969 +   XXX no answer for perf-wakeup
  11.970 +  </p>
  11.971 + </answer>
  11.972 +
  11.973 +
  11.974 +
  11.975 +<!--
  11.976 +        <question id="resources-file" when="final">
  11.977 +            Does your module use <code>java.io.File</code> directly?
  11.978 +            
  11.979 +            <hint>
  11.980 +            NetBeans provide a logical wrapper over plain files called 
  11.981 +            <code>org.openide.filesystems.FileObject</code> that
  11.982 +            provides uniform access to such resources and is the preferred
  11.983 +            way that should be used. But of course there can be situations when
  11.984 +            this is not suitable.
  11.985 +            </hint>
  11.986 +        </question>
  11.987 +-->
  11.988 + <answer id="resources-file">
  11.989 +  <p>
  11.990 +   XXX no answer for resources-file
  11.991 +  </p>
  11.992 + </answer>
  11.993 +
  11.994 +
  11.995 +
  11.996 +<!--
  11.997 +        <question id="resources-layer" when="final">
  11.998 +            Does your module provide own layer? Does it create any files or
  11.999 +            folders in it? What it is trying to communicate by that and with which 
 11.1000 +            components?
 11.1001 +            
 11.1002 +            <hint>
 11.1003 +            NetBeans allows automatic and declarative installation of resources 
 11.1004 +            by module layers. Module register files into appropriate places
 11.1005 +            and other components use that information to perform their task
 11.1006 +            (build menu, toolbar, window layout, list of templates, set of
 11.1007 +            options, etc.). 
 11.1008 +            </hint>
 11.1009 +        </question>
 11.1010 +-->
 11.1011 + <answer id="resources-layer">
 11.1012 +  <p>
 11.1013 +   XXX no answer for resources-layer
 11.1014 +  </p>
 11.1015 + </answer>
 11.1016 +
 11.1017 +
 11.1018 +
 11.1019 +<!--
 11.1020 +        <question id="resources-mask" when="final">
 11.1021 +            Does your module mask/hide/override any resources provided by other modules in
 11.1022 +            their layers?
 11.1023 +            
 11.1024 +            <hint>
 11.1025 +            If you mask a file provided by another module, you probably depend
 11.1026 +            on that and do not want the other module to (for example) change
 11.1027 +            the file's name. That module shall thus make that file available as an API
 11.1028 +            of some stability category.
 11.1029 +            </hint>
 11.1030 +        </question>
 11.1031 +-->
 11.1032 + <answer id="resources-mask">
 11.1033 +  <p>
 11.1034 +   XXX no answer for resources-mask
 11.1035 +  </p>
 11.1036 + </answer>
 11.1037 +
 11.1038 +
 11.1039 +
 11.1040 +<!--
 11.1041 +        <question id="resources-preferences" when="final">
 11.1042 +            Does your module uses preferences via Preferences API? Does your module use NbPreferences or
 11.1043 +            or regular JDK Preferences ? Does it read, write or both ? 
 11.1044 +            Does it share preferences with other modules ? If so, then why ?
 11.1045 +            <hint>
 11.1046 +                You may use
 11.1047 +                    &lt;api type="export" group="preferences"
 11.1048 +                    name="preference node name" category="private"&gt;
 11.1049 +                    description of individual keys, where it is used, what it
 11.1050 +                    influences, whether the module reads/write it, etc.
 11.1051 +                    &lt;/api&gt;
 11.1052 +                Due to XML ID restrictions, rather than /org/netbeans/modules/foo give the "name" as org.netbeans.modules.foo.
 11.1053 +                Note that if you use NbPreferences this name will then be the same as the code name base of the module.
 11.1054 +            </hint>
 11.1055 +        </question>
 11.1056 +-->
 11.1057 + <answer id="resources-preferences">
 11.1058 +  <p>
 11.1059 +   XXX no answer for resources-preferences
 11.1060 +  </p>
 11.1061 + </answer>
 11.1062 +
 11.1063 +
 11.1064 +
 11.1065 +<!--
 11.1066 +        <question id="resources-read" when="final">
 11.1067 +            Does your module read any resources from layers? For what purpose?
 11.1068 +            
 11.1069 +            <hint>
 11.1070 +            As this is some kind of intermodule dependency, it is a kind of API.
 11.1071 +            Please describe it and classify according to 
 11.1072 +            <a href="http://openide.netbeans.org/tutorial/api-design.html#categories">
 11.1073 +            common stability categories</a>.
 11.1074 +            </hint>
 11.1075 +        </question>
 11.1076 +-->
 11.1077 + <answer id="resources-read">
 11.1078 +  <p>
 11.1079 +   XXX no answer for resources-read
 11.1080 +  </p>
 11.1081 + </answer>
 11.1082 +
 11.1083 +
 11.1084 +
 11.1085 +<!--
 11.1086 +        <question id="security-grant" when="final">
 11.1087 +            Does your code grant additional rights to some other code?
 11.1088 +            <hint>Avoid using a class loader that adds extra
 11.1089 +            permissions to loaded code unless really necessary.
 11.1090 +            Also note that your API implementation
 11.1091 +            can also expose unneeded permissions to enemy code by
 11.1092 +            calling AccessController.doPrivileged().</hint>
 11.1093 +        </question>
 11.1094 +-->
 11.1095 + <answer id="security-grant">
 11.1096 +  <p>
 11.1097 +   XXX no answer for security-grant
 11.1098 +  </p>
 11.1099 + </answer>
 11.1100 +
 11.1101 +
 11.1102 +
 11.1103 +<!--
 11.1104 +        <question id="security-policy" when="final">
 11.1105 +            Does your functionality require modifications to the standard policy file?
 11.1106 +            <hint>Your code might pass control to third-party code not
 11.1107 +            coming from trusted domains. This could be code downloaded over the
 11.1108 +            network or code coming from libraries that are not bundled
 11.1109 +            with NetBeans. Which permissions need to be granted to which domains?</hint>
 11.1110 +        </question>
 11.1111 +-->
 11.1112 + <answer id="security-policy">
 11.1113 +  <p>
 11.1114 +   XXX no answer for security-policy
 11.1115 +  </p>
 11.1116 + </answer>
 11.1117 +
 11.1118 +</api-answers>

    12.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    12.2 +++ b/java.hints/spi.java.hints/build.xml	Wed May 08 21:47:42 2013 +0200
    12.3 @@ -0,0 +1,8 @@
    12.4 +<?xml version="1.0" encoding="UTF-8"?>
    12.5 +<!-- You may freely edit this file. See harness/README in the NetBeans platform -->
    12.6 +<!-- for some information on what you could do (e.g. targets to override). -->
    12.7 +<!-- If you delete this file and reopen the project it will be recreated. -->
    12.8 +<project name="org.netbeans.spi.java.hints" default="netbeans" basedir=".">
    12.9 +    <description>Builds, tests, and runs the project org.netbeans.spi.java.hints.</description>
   12.10 +    <import file="nbproject/build-impl.xml"/>
   12.11 +</project>

    13.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    13.2 +++ b/java.hints/spi.java.hints/manifest.mf	Wed May 08 21:47:42 2013 +0200
    13.3 @@ -0,0 +1,5 @@
    13.4 +Manifest-Version: 1.0
    13.5 +OpenIDE-Module: org.netbeans.spi.java.hints
    13.6 +OpenIDE-Module-Implementation-Version: 11
    13.7 +OpenIDE-Module-Localizing-Bundle: org/netbeans/modules/java/hints/spiimpl/Bundle.properties
    13.8 +

    14.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    14.2 +++ b/java.hints/spi.java.hints/nbproject/build-impl.xml	Wed May 08 21:47:42 2013 +0200
    14.3 @@ -0,0 +1,45 @@
    14.4 +<?xml version="1.0" encoding="UTF-8"?>
    14.5 +<!--
    14.6 +*** GENERATED FROM project.xml - DO NOT EDIT  ***
    14.7 +***         EDIT ../build.xml INSTEAD         ***
    14.8 +-->
    14.9 +<project name="org.netbeans.spi.java.hints-impl" basedir="..">
   14.10 +    <fail message="Please build using Ant 1.7.1 or higher.">
   14.11 +        <condition>
   14.12 +            <not>
   14.13 +                <antversion atleast="1.7.1"/>
   14.14 +            </not>
   14.15 +        </condition>
   14.16 +    </fail>
   14.17 +    <property file="nbproject/private/suite-private.properties"/>
   14.18 +    <property file="nbproject/suite.properties"/>
   14.19 +    <fail unless="suite.dir">You must set 'suite.dir' to point to your containing module suite</fail>
   14.20 +    <property file="${suite.dir}/nbproject/private/platform-private.properties"/>
   14.21 +    <property file="${suite.dir}/nbproject/platform.properties"/>
   14.22 +    <macrodef name="property" uri="http://www.netbeans.org/ns/nb-module-project/2">
   14.23 +        <attribute name="name"/>
   14.24 +        <attribute name="value"/>
   14.25 +        <sequential>
   14.26 +            <property name="@{name}" value="${@{value}}"/>
   14.27 +        </sequential>
   14.28 +    </macrodef>
   14.29 +    <macrodef name="evalprops" uri="http://www.netbeans.org/ns/nb-module-project/2">
   14.30 +        <attribute name="property"/>
   14.31 +        <attribute name="value"/>
   14.32 +        <sequential>
   14.33 +            <property name="@{property}" value="@{value}"/>
   14.34 +        </sequential>
   14.35 +    </macrodef>
   14.36 +    <property file="${user.properties.file}"/>
   14.37 +    <nbmproject2:property name="harness.dir" value="nbplatform.${nbplatform.active}.harness.dir" xmlns:nbmproject2="http://www.netbeans.org/ns/nb-module-project/2"/>
   14.38 +    <nbmproject2:property name="nbplatform.active.dir" value="nbplatform.${nbplatform.active}.netbeans.dest.dir" xmlns:nbmproject2="http://www.netbeans.org/ns/nb-module-project/2"/>
   14.39 +    <nbmproject2:evalprops property="cluster.path.evaluated" value="${cluster.path}" xmlns:nbmproject2="http://www.netbeans.org/ns/nb-module-project/2"/>
   14.40 +    <fail message="Path to 'platform' cluster missing in $${cluster.path} property or using corrupt Netbeans Platform (missing harness).">
   14.41 +        <condition>
   14.42 +            <not>
   14.43 +                <contains string="${cluster.path.evaluated}" substring="platform"/>
   14.44 +            </not>
   14.45 +        </condition>
   14.46 +    </fail>
   14.47 +    <import file="${harness.dir}/build.xml"/>
   14.48 +</project>

    15.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    15.2 +++ b/java.hints/spi.java.hints/nbproject/genfiles.properties	Wed May 08 21:47:42 2013 +0200
    15.3 @@ -0,0 +1,8 @@
    15.4 +build.xml.data.CRC32=81a58345
    15.5 +build.xml.script.CRC32=caab83d9
    15.6 +build.xml.stylesheet.CRC32=a56c6a5b@2.58
    15.7 +# This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml.
    15.8 +# Do not edit this file. You may delete it but then the IDE will never regenerate such files for you.
    15.9 +nbproject/build-impl.xml.data.CRC32=81a58345
   15.10 +nbproject/build-impl.xml.script.CRC32=7438bc77
   15.11 +nbproject/build-impl.xml.stylesheet.CRC32=238281d1@2.58

    16.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    16.2 +++ b/java.hints/spi.java.hints/nbproject/org-netbeans-spi-java-hints.sig	Wed May 08 21:47:42 2013 +0200
    16.3 @@ -0,0 +1,276 @@
    16.4 +#Signature file v4.1
    16.5 +#Version 1.10.1
    16.6 +
    16.7 +CLSS public abstract interface java.io.Serializable
    16.8 +
    16.9 +CLSS public abstract interface java.lang.Comparable<%0 extends java.lang.Object>
   16.10 +meth public abstract int compareTo({java.lang.Comparable%0})
   16.11 +
   16.12 +CLSS public abstract java.lang.Enum<%0 extends java.lang.Enum<{java.lang.Enum%0}>>
   16.13 +cons protected init(java.lang.String,int)
   16.14 +intf java.io.Serializable
   16.15 +intf java.lang.Comparable<{java.lang.Enum%0}>
   16.16 +meth protected final java.lang.Object clone() throws java.lang.CloneNotSupportedException
   16.17 +meth protected final void finalize()
   16.18 +meth public final boolean equals(java.lang.Object)
   16.19 +meth public final int compareTo({java.lang.Enum%0})
   16.20 +meth public final int hashCode()
   16.21 +meth public final int ordinal()
   16.22 +meth public final java.lang.Class<{java.lang.Enum%0}> getDeclaringClass()
   16.23 +meth public final java.lang.String name()
   16.24 +meth public java.lang.String toString()
   16.25 +meth public static <%0 extends java.lang.Enum<{%%0}>> {%%0} valueOf(java.lang.Class<{%%0}>,java.lang.String)
   16.26 +supr java.lang.Object
   16.27 +hfds name,ordinal
   16.28 +
   16.29 +CLSS public java.lang.Object
   16.30 +cons public init()
   16.31 +meth protected java.lang.Object clone() throws java.lang.CloneNotSupportedException
   16.32 +meth protected void finalize() throws java.lang.Throwable
   16.33 +meth public boolean equals(java.lang.Object)
   16.34 +meth public final java.lang.Class<?> getClass()
   16.35 +meth public final void notify()
   16.36 +meth public final void notifyAll()
   16.37 +meth public final void wait() throws java.lang.InterruptedException
   16.38 +meth public final void wait(long) throws java.lang.InterruptedException
   16.39 +meth public final void wait(long,int) throws java.lang.InterruptedException
   16.40 +meth public int hashCode()
   16.41 +meth public java.lang.String toString()
   16.42 +
   16.43 +CLSS public abstract interface java.lang.annotation.Annotation
   16.44 +meth public abstract boolean equals(java.lang.Object)
   16.45 +meth public abstract int hashCode()
   16.46 +meth public abstract java.lang.Class<? extends java.lang.annotation.Annotation> annotationType()
   16.47 +meth public abstract java.lang.String toString()
   16.48 +
   16.49 +CLSS public abstract interface !annotation java.lang.annotation.Documented
   16.50 + anno 0 java.lang.annotation.Documented()
   16.51 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=RUNTIME)
   16.52 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[ANNOTATION_TYPE])
   16.53 +intf java.lang.annotation.Annotation
   16.54 +
   16.55 +CLSS public abstract interface !annotation java.lang.annotation.Retention
   16.56 + anno 0 java.lang.annotation.Documented()
   16.57 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=RUNTIME)
   16.58 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[ANNOTATION_TYPE])
   16.59 +intf java.lang.annotation.Annotation
   16.60 +meth public abstract java.lang.annotation.RetentionPolicy value()
   16.61 +
   16.62 +CLSS public abstract interface !annotation java.lang.annotation.Target
   16.63 + anno 0 java.lang.annotation.Documented()
   16.64 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=RUNTIME)
   16.65 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[ANNOTATION_TYPE])
   16.66 +intf java.lang.annotation.Annotation
   16.67 +meth public abstract java.lang.annotation.ElementType[] value()
   16.68 +
   16.69 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.BooleanOption
   16.70 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=SOURCE)
   16.71 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[FIELD])
   16.72 +intf java.lang.annotation.Annotation
   16.73 +meth public abstract boolean defaultValue()
   16.74 +meth public abstract java.lang.String displayName()
   16.75 +meth public abstract java.lang.String tooltip()
   16.76 +
   16.77 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.ConstraintVariableType
   16.78 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[])
   16.79 +intf java.lang.annotation.Annotation
   16.80 +meth public abstract java.lang.String type()
   16.81 +meth public abstract java.lang.String variable()
   16.82 +
   16.83 +CLSS public abstract interface org.netbeans.spi.java.hints.CustomizerProvider
   16.84 +meth public abstract javax.swing.JComponent getCustomizer(java.util.prefs.Preferences)
   16.85 + anno 0 org.netbeans.api.annotations.common.NonNull()
   16.86 + anno 1 org.netbeans.api.annotations.common.NonNull()
   16.87 +
   16.88 +CLSS public org.netbeans.spi.java.hints.ErrorDescriptionFactory
   16.89 +meth public !varargs static org.netbeans.spi.editor.hints.ErrorDescription forName(org.netbeans.spi.java.hints.HintContext,com.sun.source.tree.Tree,java.lang.String,org.netbeans.spi.editor.hints.Fix[])
   16.90 +meth public !varargs static org.netbeans.spi.editor.hints.ErrorDescription forName(org.netbeans.spi.java.hints.HintContext,com.sun.source.util.TreePath,java.lang.String,org.netbeans.spi.editor.hints.Fix[])
   16.91 +meth public !varargs static org.netbeans.spi.editor.hints.ErrorDescription forSpan(org.netbeans.spi.java.hints.HintContext,int,int,java.lang.String,org.netbeans.spi.editor.hints.Fix[])
   16.92 +meth public !varargs static org.netbeans.spi.editor.hints.ErrorDescription forTree(org.netbeans.spi.java.hints.HintContext,com.sun.source.tree.Tree,java.lang.String,org.netbeans.spi.editor.hints.Fix[])
   16.93 +meth public !varargs static org.netbeans.spi.editor.hints.ErrorDescription forTree(org.netbeans.spi.java.hints.HintContext,com.sun.source.util.TreePath,java.lang.String,org.netbeans.spi.editor.hints.Fix[])
   16.94 +supr java.lang.Object
   16.95 +hfds DECLARATION
   16.96 +hcls DisableConfigure,FixImpl,InspectFix,TopLevelConfigureFix
   16.97 +
   16.98 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.Hint
   16.99 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=SOURCE)
  16.100 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[TYPE, METHOD])
  16.101 +innr public final static !enum Kind
  16.102 +innr public final static !enum Options
  16.103 +intf java.lang.annotation.Annotation
  16.104 +meth public abstract !hasdefault boolean enabled()
  16.105 +meth public abstract !hasdefault java.lang.Class<? extends org.netbeans.spi.java.hints.CustomizerProvider> customizerProvider()
  16.106 +meth public abstract !hasdefault java.lang.String id()
  16.107 +meth public abstract !hasdefault java.lang.String[] suppressWarnings()
  16.108 +meth public abstract !hasdefault org.netbeans.spi.editor.hints.Severity severity()
  16.109 +meth public abstract !hasdefault org.netbeans.spi.java.hints.Hint$Kind hintKind()
  16.110 +meth public abstract !hasdefault org.netbeans.spi.java.hints.Hint$Options[] options()
  16.111 +meth public abstract java.lang.String category()
  16.112 +meth public abstract java.lang.String description()
  16.113 +meth public abstract java.lang.String displayName()
  16.114 +
  16.115 +CLSS public final static !enum org.netbeans.spi.java.hints.Hint$Kind
  16.116 + outer org.netbeans.spi.java.hints.Hint
  16.117 +fld public final static org.netbeans.spi.java.hints.Hint$Kind ACTION
  16.118 +fld public final static org.netbeans.spi.java.hints.Hint$Kind INSPECTION
  16.119 +meth public static org.netbeans.spi.java.hints.Hint$Kind valueOf(java.lang.String)
  16.120 +meth public static org.netbeans.spi.java.hints.Hint$Kind[] values()
  16.121 +supr java.lang.Enum<org.netbeans.spi.java.hints.Hint$Kind>
  16.122 +
  16.123 +CLSS public final static !enum org.netbeans.spi.java.hints.Hint$Options
  16.124 + outer org.netbeans.spi.java.hints.Hint
  16.125 +fld public final static org.netbeans.spi.java.hints.Hint$Options NO_BATCH
  16.126 +fld public final static org.netbeans.spi.java.hints.Hint$Options QUERY
  16.127 +meth public static org.netbeans.spi.java.hints.Hint$Options valueOf(java.lang.String)
  16.128 +meth public static org.netbeans.spi.java.hints.Hint$Options[] values()
  16.129 +supr java.lang.Enum<org.netbeans.spi.java.hints.Hint$Options>
  16.130 +
  16.131 +CLSS public org.netbeans.spi.java.hints.HintContext
  16.132 +innr public final static !enum MessageKind
  16.133 +meth public boolean isBulkMode()
  16.134 +meth public boolean isCanceled()
  16.135 +meth public com.sun.source.util.TreePath getPath()
  16.136 +meth public int getCaretLocation()
  16.137 +meth public java.util.Map<java.lang.String,com.sun.source.util.TreePath> getVariables()
  16.138 +meth public java.util.Map<java.lang.String,java.lang.String> getVariableNames()
  16.139 +meth public java.util.Map<java.lang.String,java.util.Collection<? extends com.sun.source.util.TreePath>> getMultiVariables()
  16.140 +meth public java.util.Map<java.lang.String,javax.lang.model.type.TypeMirror> getConstraints()
  16.141 +meth public java.util.prefs.Preferences getPreferences()
  16.142 +meth public org.netbeans.api.java.source.CompilationInfo getInfo()
  16.143 +meth public org.netbeans.spi.editor.hints.Severity getSeverity()
  16.144 +meth public void reportMessage(org.netbeans.spi.java.hints.HintContext$MessageKind,java.lang.String)
  16.145 +supr java.lang.Object
  16.146 +hfds bulkMode,cancel,caret,constraints,info,messages,metadata,multiVariables,path,preferences,severity,variableNames,variables
  16.147 +
  16.148 +CLSS public final static !enum org.netbeans.spi.java.hints.HintContext$MessageKind
  16.149 + outer org.netbeans.spi.java.hints.HintContext
  16.150 +fld public final static org.netbeans.spi.java.hints.HintContext$MessageKind ERROR
  16.151 +fld public final static org.netbeans.spi.java.hints.HintContext$MessageKind WARNING
  16.152 +meth public static org.netbeans.spi.java.hints.HintContext$MessageKind valueOf(java.lang.String)
  16.153 +meth public static org.netbeans.spi.java.hints.HintContext$MessageKind[] values()
  16.154 +supr java.lang.Enum<org.netbeans.spi.java.hints.HintContext$MessageKind>
  16.155 +
  16.156 +CLSS public final !enum org.netbeans.spi.java.hints.HintSeverity
  16.157 +fld public final static org.netbeans.spi.java.hints.HintSeverity CURRENT_LINE_WARNING
  16.158 +fld public final static org.netbeans.spi.java.hints.HintSeverity ERROR
  16.159 +fld public final static org.netbeans.spi.java.hints.HintSeverity WARNING
  16.160 +meth public org.netbeans.spi.editor.hints.Severity toEditorSeverity()
  16.161 +meth public static org.netbeans.spi.java.hints.HintSeverity valueOf(java.lang.String)
  16.162 +meth public static org.netbeans.spi.java.hints.HintSeverity[] values()
  16.163 +supr java.lang.Enum<org.netbeans.spi.java.hints.HintSeverity>
  16.164 +
  16.165 +CLSS public abstract org.netbeans.spi.java.hints.JavaFix
  16.166 +cons protected init(org.netbeans.api.java.source.CompilationInfo,com.sun.source.util.TreePath)
  16.167 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.168 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.169 +cons protected init(org.netbeans.api.java.source.TreePathHandle)
  16.170 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.171 +innr public final static TransformationContext
  16.172 +meth protected abstract java.lang.String getText()
  16.173 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.174 +meth protected abstract void performRewrite(org.netbeans.spi.java.hints.JavaFix$TransformationContext) throws java.lang.Exception
  16.175 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.176 +meth public final org.netbeans.spi.editor.hints.Fix toEditorFix()
  16.177 +supr java.lang.Object
  16.178 +hfds LOG,handle,options
  16.179 +
  16.180 +CLSS public final static org.netbeans.spi.java.hints.JavaFix$TransformationContext
  16.181 + outer org.netbeans.spi.java.hints.JavaFix
  16.182 +meth public com.sun.source.util.TreePath getPath()
  16.183 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.184 +meth public java.io.InputStream getResourceContent(org.openide.filesystems.FileObject) throws java.io.IOException
  16.185 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.186 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.187 +meth public java.io.OutputStream getResourceOutput(org.openide.filesystems.FileObject) throws java.io.IOException
  16.188 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.189 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.190 +meth public org.netbeans.api.java.source.WorkingCopy getWorkingCopy()
  16.191 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.192 +supr java.lang.Object
  16.193 +hfds canShowUI,fileChanges,path,resourceContentChanges,workingCopy
  16.194 +
  16.195 +CLSS public org.netbeans.spi.java.hints.JavaFixUtilities
  16.196 +cons public init()
  16.197 +meth public static boolean requiresParenthesis(com.sun.source.tree.Tree,com.sun.source.tree.Tree,com.sun.source.tree.Tree)
  16.198 +meth public static org.netbeans.spi.editor.hints.Fix removeFromParent(org.netbeans.spi.java.hints.HintContext,java.lang.String,com.sun.source.util.TreePath)
  16.199 +meth public static org.netbeans.spi.editor.hints.Fix rewriteFix(org.netbeans.spi.java.hints.HintContext,java.lang.String,com.sun.source.util.TreePath,java.lang.String)
  16.200 +supr java.lang.Object
  16.201 +hfds NUMBER_LITERAL_KINDS,OPERATOR_PRIORITIES,SPEC_VERSION
  16.202 +hcls JavaFixRealImpl,MoveFile,RemoveFromParent,ReplaceParameters
  16.203 +
  16.204 +CLSS public org.netbeans.spi.java.hints.MatcherUtilities
  16.205 +cons public init()
  16.206 +meth public static boolean matches(org.netbeans.spi.java.hints.HintContext,com.sun.source.util.TreePath,java.lang.String)
  16.207 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.208 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.209 + anno 3 org.netbeans.api.annotations.common.NonNull()
  16.210 +meth public static boolean matches(org.netbeans.spi.java.hints.HintContext,com.sun.source.util.TreePath,java.lang.String,boolean)
  16.211 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.212 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.213 + anno 3 org.netbeans.api.annotations.common.NonNull()
  16.214 +meth public static boolean matches(org.netbeans.spi.java.hints.HintContext,com.sun.source.util.TreePath,java.lang.String,java.util.Map<java.lang.String,com.sun.source.util.TreePath>,java.util.Map<java.lang.String,java.util.Collection<? extends com.sun.source.util.TreePath>>,java.util.Map<java.lang.String,java.lang.String>)
  16.215 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.216 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.217 + anno 3 org.netbeans.api.annotations.common.NonNull()
  16.218 +meth public static boolean matches(org.netbeans.spi.java.hints.HintContext,java.util.Collection<? extends com.sun.source.util.TreePath>,java.lang.String,java.util.Map<java.lang.String,com.sun.source.util.TreePath>,java.util.Map<java.lang.String,java.util.Collection<? extends com.sun.source.util.TreePath>>,java.util.Map<java.lang.String,java.lang.String>)
  16.219 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.220 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.221 + anno 3 org.netbeans.api.annotations.common.NonNull()
  16.222 +supr java.lang.Object
  16.223 +
  16.224 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.TriggerPattern
  16.225 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=SOURCE)
  16.226 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[METHOD])
  16.227 +intf java.lang.annotation.Annotation
  16.228 +meth public abstract !hasdefault org.netbeans.spi.java.hints.ConstraintVariableType[] constraints()
  16.229 +meth public abstract java.lang.String value()
  16.230 +
  16.231 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.TriggerPatterns
  16.232 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=SOURCE)
  16.233 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[METHOD])
  16.234 +intf java.lang.annotation.Annotation
  16.235 +meth public abstract org.netbeans.spi.java.hints.TriggerPattern[] value()
  16.236 +
  16.237 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.TriggerTreeKind
  16.238 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=SOURCE)
  16.239 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[METHOD])
  16.240 +intf java.lang.annotation.Annotation
  16.241 +meth public abstract com.sun.source.tree.Tree$Kind[] value()
  16.242 +
  16.243 +CLSS public abstract interface !annotation org.netbeans.spi.java.hints.UseOptions
  16.244 + anno 0 java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy value=SOURCE)
  16.245 + anno 0 java.lang.annotation.Target(java.lang.annotation.ElementType[] value=[METHOD])
  16.246 +intf java.lang.annotation.Annotation
  16.247 +meth public abstract java.lang.String[] value()
  16.248 +
  16.249 +CLSS public final org.netbeans.spi.java.hints.support.FixFactory
  16.250 +meth public final static org.netbeans.spi.editor.hints.Fix addModifiersFix(org.netbeans.api.java.source.CompilationInfo,com.sun.source.util.TreePath,java.util.Set<javax.lang.model.element.Modifier>,java.lang.String)
  16.251 +meth public final static org.netbeans.spi.editor.hints.Fix changeModifiersFix(org.netbeans.api.java.source.CompilationInfo,com.sun.source.util.TreePath,java.util.Set<javax.lang.model.element.Modifier>,java.util.Set<javax.lang.model.element.Modifier>,java.lang.String)
  16.252 +meth public final static org.netbeans.spi.editor.hints.Fix removeModifiersFix(org.netbeans.api.java.source.CompilationInfo,com.sun.source.util.TreePath,java.util.Set<javax.lang.model.element.Modifier>,java.lang.String)
  16.253 +supr java.lang.Object
  16.254 +hcls ChangeModifiersFixImpl
  16.255 +
  16.256 +CLSS public final org.netbeans.spi.java.hints.support.TransformationSupport
  16.257 +innr public abstract interface static Transformer
  16.258 +meth public java.util.Collection<? extends org.netbeans.api.java.source.ModificationResult> processAllProjects()
  16.259 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.260 +meth public org.netbeans.spi.java.hints.support.TransformationSupport setCancel(java.util.concurrent.atomic.AtomicBoolean)
  16.261 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.262 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.263 +meth public static org.netbeans.spi.java.hints.support.TransformationSupport create(java.lang.String)
  16.264 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.265 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.266 +meth public static org.netbeans.spi.java.hints.support.TransformationSupport create(java.lang.String,org.netbeans.spi.java.hints.support.TransformationSupport$Transformer)
  16.267 + anno 0 org.netbeans.api.annotations.common.NonNull()
  16.268 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.269 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.270 +meth public void transformTreePath(org.netbeans.api.java.source.WorkingCopy,com.sun.source.util.TreePath)
  16.271 + anno 1 org.netbeans.api.annotations.common.NonNull()
  16.272 + anno 2 org.netbeans.api.annotations.common.NonNull()
  16.273 +supr java.lang.Object
  16.274 +hfds cancel,jackpotPattern,transformer
  16.275 +
  16.276 +CLSS public abstract interface static org.netbeans.spi.java.hints.support.TransformationSupport$Transformer
  16.277 + outer org.netbeans.spi.java.hints.support.TransformationSupport
  16.278 +meth public abstract void transform(org.netbeans.api.java.source.WorkingCopy,org.netbeans.api.java.source.matching.Occurrence)
  16.279 +

    17.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    17.2 +++ b/java.hints/spi.java.hints/nbproject/project.properties	Wed May 08 21:47:42 2013 +0200
    17.3 @@ -0,0 +1,7 @@
    17.4 +is.autoload=true
    17.5 +javac.source=1.7
    17.6 +javac.compilerargs=-Xlint -Xlint:-serial
    17.7 +spec.version.base=2.0.0
    17.8 +requires.nb.javac=true
    17.9 +javadoc.arch=${basedir}/arch.xml
   17.10 +javadoc.apichanges=${basedir}/apichanges.xml

    18.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.2 +++ b/java.hints/spi.java.hints/nbproject/project.xml	Wed May 08 21:47:42 2013 +0200
    18.3 @@ -0,0 +1,456 @@
    18.4 +<?xml version="1.0" encoding="UTF-8"?>
    18.5 +<project xmlns="http://www.netbeans.org/ns/project/1">
    18.6 +    <type>org.netbeans.modules.apisupport.project</type>
    18.7 +    <configuration>
    18.8 +        <data xmlns="http://www.netbeans.org/ns/nb-module-project/3">
    18.9 +            <code-name-base>org.netbeans.spi.java.hints</code-name-base>
   18.10 +            <suite-component/>
   18.11 +            <module-dependencies>
   18.12 +                <dependency>
   18.13 +                    <code-name-base>org.netbeans.api.annotations.common</code-name-base>
   18.14 +                    <build-prerequisite/>
   18.15 +                    <compile-dependency/>
   18.16 +                    <run-dependency>
   18.17 +                        <release-version>1</release-version>
   18.18 +                        <specification-version>1.4</specification-version>
   18.19 +                    </run-dependency>
   18.20 +                </dependency>
   18.21 +                <dependency>
   18.22 +                    <code-name-base>org.netbeans.api.java</code-name-base>
   18.23 +                    <build-prerequisite/>
   18.24 +                    <compile-dependency/>
   18.25 +                    <run-dependency>
   18.26 +                        <release-version>1</release-version>
   18.27 +                        <specification-version>1.18</specification-version>
   18.28 +                    </run-dependency>
   18.29 +                </dependency>
   18.30 +                <dependency>
   18.31 +                    <code-name-base>org.netbeans.api.java.classpath</code-name-base>
   18.32 +                    <build-prerequisite/>
   18.33 +                    <compile-dependency/>
   18.34 +                    <run-dependency>
   18.35 +                        <release-version>1</release-version>
   18.36 +                        <specification-version>1.24</specification-version>
   18.37 +                    </run-dependency>
   18.38 +                </dependency>
   18.39 +                <dependency>
   18.40 +                    <code-name-base>org.netbeans.api.progress</code-name-base>
   18.41 +                    <build-prerequisite/>
   18.42 +                    <compile-dependency/>
   18.43 +                    <run-dependency>
   18.44 +                        <release-version>1</release-version>
   18.45 +                        <specification-version>1.16</specification-version>
   18.46 +                    </run-dependency>
   18.47 +                </dependency>
   18.48 +                <dependency>
   18.49 +                    <code-name-base>org.netbeans.lib.nbjavac</code-name-base>
   18.50 +                    <build-prerequisite/>
   18.51 +                    <compile-dependency/>
   18.52 +                    <run-dependency>
   18.53 +                        <implementation-version/>
   18.54 +                    </run-dependency>
   18.55 +                </dependency>
   18.56 +                <dependency>
   18.57 +                    <code-name-base>org.netbeans.libs.javacapi</code-name-base>
   18.58 +                    <build-prerequisite/>
   18.59 +                    <compile-dependency/>
   18.60 +                    <run-dependency>
   18.61 +                        <specification-version>8.0</specification-version>
   18.62 +                    </run-dependency>
   18.63 +                </dependency>
   18.64 +                <dependency>
   18.65 +                    <code-name-base>org.netbeans.libs.javacimpl</code-name-base>
   18.66 +                    <build-prerequisite/>
   18.67 +                    <compile-dependency/>
   18.68 +                    <run-dependency>
   18.69 +                        <release-version>1</release-version>
   18.70 +                        <implementation-version/>
   18.71 +                    </run-dependency>
   18.72 +                </dependency>
   18.73 +                <dependency>
   18.74 +                    <code-name-base>org.netbeans.libs.lucene</code-name-base>
   18.75 +                    <build-prerequisite/>
   18.76 +                    <compile-dependency/>
   18.77 +                    <run-dependency>
   18.78 +                        <release-version>3</release-version>
   18.79 +                        <specification-version>3.0</specification-version>
   18.80 +                    </run-dependency>
   18.81 +                </dependency>
   18.82 +                <dependency>
   18.83 +                    <code-name-base>org.netbeans.modules.code.analysis</code-name-base>
   18.84 +                    <build-prerequisite/>
   18.85 +                    <compile-dependency/>
   18.86 +                    <run-dependency>
   18.87 +                        <release-version>0</release-version>
   18.88 +                        <specification-version>1.8</specification-version>
   18.89 +                    </run-dependency>
   18.90 +                </dependency>
   18.91 +                <dependency>
   18.92 +                    <code-name-base>org.netbeans.modules.editor</code-name-base>
   18.93 +                    <build-prerequisite/>
   18.94 +                    <compile-dependency/>
   18.95 +                    <run-dependency>
   18.96 +                        <release-version>3</release-version>
   18.97 +                        <specification-version>1.53</specification-version>
   18.98 +                    </run-dependency>
   18.99 +                </dependency>
  18.100 +                <dependency>
  18.101 +                    <code-name-base>org.netbeans.modules.editor.errorstripe.api</code-name-base>
  18.102 +                    <build-prerequisite/>
  18.103 +                    <compile-dependency/>
  18.104 +                    <run-dependency>
  18.105 +                        <release-version>1</release-version>
  18.106 +                        <specification-version>2.3</specification-version>
  18.107 +                    </run-dependency>
  18.108 +                </dependency>
  18.109 +                <dependency>
  18.110 +                    <code-name-base>org.netbeans.modules.editor.lib</code-name-base>
  18.111 +                    <build-prerequisite/>
  18.112 +                    <compile-dependency/>
  18.113 +                    <run-dependency>
  18.114 +                        <release-version>3</release-version>
  18.115 +                        <specification-version>3.1</specification-version>
  18.116 +                    </run-dependency>
  18.117 +                </dependency>
  18.118 +                <dependency>
  18.119 +                    <code-name-base>org.netbeans.modules.editor.lib2</code-name-base>
  18.120 +                    <build-prerequisite/>
  18.121 +                    <compile-dependency/>
  18.122 +                    <run-dependency>
  18.123 +                        <release-version>1</release-version>
  18.124 +                        <specification-version>1.8</specification-version>
  18.125 +                    </run-dependency>
  18.126 +                </dependency>
  18.127 +                <dependency>
  18.128 +                    <code-name-base>org.netbeans.modules.editor.mimelookup</code-name-base>
  18.129 +                    <build-prerequisite/>
  18.130 +                    <compile-dependency/>
  18.131 +                    <run-dependency>
  18.132 +                        <release-version>1</release-version>
  18.133 +                        <specification-version>1.15</specification-version>
  18.134 +                    </run-dependency>
  18.135 +                </dependency>
  18.136 +                <dependency>
  18.137 +                    <code-name-base>org.netbeans.modules.editor.settings</code-name-base>
  18.138 +                    <build-prerequisite/>
  18.139 +                    <compile-dependency/>
  18.140 +                    <run-dependency>
  18.141 +                        <release-version>1</release-version>
  18.142 +                        <specification-version>1.28</specification-version>
  18.143 +                    </run-dependency>
  18.144 +                </dependency>
  18.145 +                <dependency>
  18.146 +                    <code-name-base>org.netbeans.modules.editor.util</code-name-base>
  18.147 +                    <build-prerequisite/>
  18.148 +                    <compile-dependency/>
  18.149 +                    <run-dependency>
  18.150 +                        <release-version>1</release-version>
  18.151 +                        <specification-version>1.33</specification-version>
  18.152 +                    </run-dependency>
  18.153 +                </dependency>
  18.154 +                <dependency>
  18.155 +                    <code-name-base>org.netbeans.modules.java.lexer</code-name-base>
  18.156 +                    <build-prerequisite/>
  18.157 +                    <compile-dependency/>
  18.158 +                    <run-dependency>
  18.159 +                        <release-version>1</release-version>
  18.160 +                        <specification-version>1.0</specification-version>
  18.161 +                    </run-dependency>
  18.162 +                </dependency>
  18.163 +                <dependency>
  18.164 +                    <code-name-base>org.netbeans.modules.java.platform</code-name-base>
  18.165 +                    <build-prerequisite/>
  18.166 +                    <compile-dependency/>
  18.167 +                    <run-dependency>
  18.168 +                        <release-version>1</release-version>
  18.169 +                        <specification-version>1.16</specification-version>
  18.170 +                    </run-dependency>
  18.171 +                </dependency>
  18.172 +                <dependency>
  18.173 +                    <code-name-base>org.netbeans.modules.java.project</code-name-base>
  18.174 +                    <build-prerequisite/>
  18.175 +                    <compile-dependency/>
  18.176 +                    <run-dependency>
  18.177 +                        <release-version>1</release-version>
  18.178 +                        <specification-version>1.41</specification-version>
  18.179 +                    </run-dependency>
  18.180 +                </dependency>
  18.181 +                <dependency>
  18.182 +                    <code-name-base>org.netbeans.modules.java.source</code-name-base>
  18.183 +                    <build-prerequisite/>
  18.184 +                    <compile-dependency/>
  18.185 +                    <run-dependency>
  18.186 +                        <implementation-version/>
  18.187 +                    </run-dependency>
  18.188 +                </dependency>
  18.189 +                <dependency>
  18.190 +                    <code-name-base>org.netbeans.modules.lexer</code-name-base>
  18.191 +                    <build-prerequisite/>
  18.192 +                    <compile-dependency/>
  18.193 +                    <run-dependency>
  18.194 +                        <release-version>2</release-version>
  18.195 +                        <specification-version>1.25</specification-version>
  18.196 +                    </run-dependency>
  18.197 +                </dependency>
  18.198 +                <dependency>
  18.199 +                    <code-name-base>org.netbeans.modules.options.api</code-name-base>
  18.200 +                    <build-prerequisite/>
  18.201 +                    <compile-dependency/>
  18.202 +                    <run-dependency>
  18.203 +                        <release-version>1</release-version>
  18.204 +                        <specification-version>1.5</specification-version>
  18.205 +                    </run-dependency>
  18.206 +                </dependency>
  18.207 +                <dependency>
  18.208 +                    <code-name-base>org.netbeans.modules.options.editor</code-name-base>
  18.209 +                    <build-prerequisite/>
  18.210 +                    <compile-dependency/>
  18.211 +                    <run-dependency>
  18.212 +                        <release-version>1</release-version>
  18.213 +                        <specification-version>1.28</specification-version>
  18.214 +                    </run-dependency>
  18.215 +                </dependency>
  18.216 +                <dependency>
  18.217 +                    <code-name-base>org.netbeans.modules.parsing.api</code-name-base>
  18.218 +                    <build-prerequisite/>
  18.219 +                    <compile-dependency/>
  18.220 +                    <run-dependency>
  18.221 +                        <release-version>1</release-version>
  18.222 +                        <implementation-version/>
  18.223 +                    </run-dependency>
  18.224 +                </dependency>
  18.225 +                <dependency>
  18.226 +                    <code-name-base>org.netbeans.modules.projectapi</code-name-base>
  18.227 +                    <build-prerequisite/>
  18.228 +                    <compile-dependency/>
  18.229 +                    <run-dependency>
  18.230 +                        <release-version>1</release-version>
  18.231 +                        <specification-version>1.42</specification-version>
  18.232 +                    </run-dependency>
  18.233 +                </dependency>
  18.234 +                <dependency>
  18.235 +                    <code-name-base>org.netbeans.modules.queries</code-name-base>
  18.236 +                    <build-prerequisite/>
  18.237 +                    <compile-dependency/>
  18.238 +                    <run-dependency>
  18.239 +                        <release-version>1</release-version>
  18.240 +                        <specification-version>1.18</specification-version>
  18.241 +                    </run-dependency>
  18.242 +                </dependency>
  18.243 +                <dependency>
  18.244 +                    <code-name-base>org.netbeans.modules.refactoring.api</code-name-base>
  18.245 +                    <build-prerequisite/>
  18.246 +                    <compile-dependency/>
  18.247 +                    <run-dependency>
  18.248 +                        <specification-version>1.23</specification-version>
  18.249 +                    </run-dependency>
  18.250 +                </dependency>
  18.251 +                <dependency>
  18.252 +                    <code-name-base>org.netbeans.spi.editor.hints</code-name-base>
  18.253 +                    <build-prerequisite/>
  18.254 +                    <compile-dependency/>
  18.255 +                    <run-dependency>
  18.256 +                        <release-version>0-1</release-version>
  18.257 +                        <specification-version>1.22</specification-version>
  18.258 +                    </run-dependency>
  18.259 +                </dependency>
  18.260 +                <dependency>
  18.261 +                    <code-name-base>org.openide.actions</code-name-base>
  18.262 +                    <build-prerequisite/>
  18.263 +                    <compile-dependency/>
  18.264 +                    <run-dependency>
  18.265 +                        <specification-version>6.15</specification-version>
  18.266 +                    </run-dependency>
  18.267 +                </dependency>
  18.268 +                <dependency>
  18.269 +                    <code-name-base>org.openide.awt</code-name-base>
  18.270 +                    <build-prerequisite/>
  18.271 +                    <compile-dependency/>
  18.272 +                    <run-dependency>
  18.273 +                        <specification-version>6.10</specification-version>
  18.274 +                    </run-dependency>
  18.275 +                </dependency>
  18.276 +                <dependency>
  18.277 +                    <code-name-base>org.openide.dialogs</code-name-base>
  18.278 +                    <build-prerequisite/>
  18.279 +                    <compile-dependency/>
  18.280 +                    <run-dependency>
  18.281 +                        <specification-version>7.0</specification-version>
  18.282 +                    </run-dependency>
  18.283 +                </dependency>
  18.284 +                <dependency>
  18.285 +                    <code-name-base>org.openide.explorer</code-name-base>
  18.286 +                    <build-prerequisite/>
  18.287 +                    <compile-dependency/>
  18.288 +                    <run-dependency>
  18.289 +                        <specification-version>6.22</specification-version>
  18.290 +                    </run-dependency>
  18.291 +                </dependency>
  18.292 +                <dependency>
  18.293 +                    <code-name-base>org.openide.filesystems</code-name-base>
  18.294 +                    <build-prerequisite/>
  18.295 +                    <compile-dependency/>
  18.296 +                    <run-dependency>
  18.297 +                        <specification-version>7.19</specification-version>
  18.298 +                    </run-dependency>
  18.299 +                </dependency>
  18.300 +                <dependency>
  18.301 +                    <code-name-base>org.openide.loaders</code-name-base>
  18.302 +                    <build-prerequisite/>
  18.303 +                    <compile-dependency/>
  18.304 +                    <run-dependency/>
  18.305 +                </dependency>
  18.306 +                <dependency>
  18.307 +                    <code-name-base>org.openide.modules</code-name-base>
  18.308 +                    <build-prerequisite/>
  18.309 +                    <compile-dependency/>
  18.310 +                    <run-dependency>
  18.311 +                        <specification-version>7.3</specification-version>
  18.312 +                    </run-dependency>
  18.313 +                </dependency>
  18.314 +                <dependency>
  18.315 +                    <code-name-base>org.openide.nodes</code-name-base>
  18.316 +                    <build-prerequisite/>
  18.317 +                    <compile-dependency/>
  18.318 +                    <run-dependency>
  18.319 +                        <specification-version>6.2</specification-version>
  18.320 +                    </run-dependency>
  18.321 +                </dependency>
  18.322 +                <dependency>
  18.323 +                    <code-name-base>org.openide.text</code-name-base>
  18.324 +                    <build-prerequisite/>
  18.325 +                    <compile-dependency/>
  18.326 +                    <run-dependency>
  18.327 +                        <specification-version>6.16</specification-version>
  18.328 +                    </run-dependency>
  18.329 +                </dependency>
  18.330 +                <dependency>
  18.331 +                    <code-name-base>org.openide.util</code-name-base>
  18.332 +                    <build-prerequisite/>
  18.333 +                    <compile-dependency/>
  18.334 +                    <run-dependency>
  18.335 +                        <specification-version>8.32</specification-version>
  18.336 +                    </run-dependency>
  18.337 +                </dependency>
  18.338 +                <dependency>
  18.339 +                    <code-name-base>org.openide.util.lookup</code-name-base>
  18.340 +                    <build-prerequisite/>
  18.341 +                    <compile-dependency/>
  18.342 +                    <run-dependency>
  18.343 +                        <specification-version>8.0</specification-version>
  18.344 +                    </run-dependency>
  18.345 +                </dependency>
  18.346 +                <dependency>
  18.347 +                    <code-name-base>org.openide.windows</code-name-base>
  18.348 +                    <build-prerequisite/>
  18.349 +                    <compile-dependency/>
  18.350 +                    <run-dependency>
  18.351 +                        <specification-version>6.16</specification-version>
  18.352 +                    </run-dependency>
  18.353 +                </dependency>
  18.354 +            </module-dependencies>
  18.355 +            <test-dependencies>
  18.356 +                <test-type>
  18.357 +                    <name>unit</name>
  18.358 +                    <test-dependency>
  18.359 +                        <code-name-base>org.netbeans.core</code-name-base>
  18.360 +                        <compile-dependency/>
  18.361 +                    </test-dependency>
  18.362 +                    <test-dependency>
  18.363 +                        <code-name-base>org.netbeans.insane</code-name-base>
  18.364 +                        <compile-dependency/>
  18.365 +                    </test-dependency>
  18.366 +                    <test-dependency>
  18.367 +                        <code-name-base>org.netbeans.libs.freemarker</code-name-base>
  18.368 +                        <recursive/>
  18.369 +                        <compile-dependency/>
  18.370 +                    </test-dependency>
  18.371 +                    <test-dependency>
  18.372 +                        <code-name-base>org.netbeans.libs.junit4</code-name-base>
  18.373 +                        <compile-dependency/>
  18.374 +                    </test-dependency>
  18.375 +                    <test-dependency>
  18.376 +                        <code-name-base>org.netbeans.modules.classfile</code-name-base>
  18.377 +                    </test-dependency>
  18.378 +                    <test-dependency>
  18.379 +                        <code-name-base>org.netbeans.modules.defaults</code-name-base>
  18.380 +                    </test-dependency>
  18.381 +                    <test-dependency>
  18.382 +                        <code-name-base>org.netbeans.modules.editor</code-name-base>
  18.383 +                        <test/>
  18.384 +                    </test-dependency>
  18.385 +                    <test-dependency>
  18.386 +                        <code-name-base>org.netbeans.modules.editor.mimelookup</code-name-base>
  18.387 +                        <compile-dependency/>
  18.388 +                        <test/>
  18.389 +                    </test-dependency>
  18.390 +                    <test-dependency>
  18.391 +                        <code-name-base>org.netbeans.modules.editor.settings</code-name-base>
  18.392 +                    </test-dependency>
  18.393 +                    <test-dependency>
  18.394 +                        <code-name-base>org.netbeans.modules.editor.settings.storage</code-name-base>
  18.395 +                    </test-dependency>
  18.396 +                    <test-dependency>
  18.397 +                        <code-name-base>org.netbeans.modules.editor.util</code-name-base>
  18.398 +                    </test-dependency>
  18.399 +                    <test-dependency>
  18.400 +                        <code-name-base>org.netbeans.modules.jackpot30.test.borrowed</code-name-base>
  18.401 +                        <compile-dependency/>
  18.402 +                    </test-dependency>
  18.403 +                    <test-dependency>
  18.404 +                        <code-name-base>org.netbeans.modules.java.editor</code-name-base>
  18.405 +                        <recursive/>
  18.406 +                        <compile-dependency/>
  18.407 +                    </test-dependency>
  18.408 +                    <test-dependency>
  18.409 +                        <code-name-base>org.netbeans.modules.java.hints</code-name-base>
  18.410 +                        <compile-dependency/>
  18.411 +                    </test-dependency>
  18.412 +                    <test-dependency>
  18.413 +                        <code-name-base>org.netbeans.modules.java.hints.declarative</code-name-base>
  18.414 +                        <compile-dependency/>
  18.415 +                    </test-dependency>
  18.416 +                    <test-dependency>
  18.417 +                        <code-name-base>org.netbeans.modules.java.source</code-name-base>
  18.418 +                        <compile-dependency/>
  18.419 +                        <test/>
  18.420 +                    </test-dependency>
  18.421 +                    <test-dependency>
  18.422 +                        <code-name-base>org.netbeans.modules.masterfs</code-name-base>
  18.423 +                    </test-dependency>
  18.424 +                    <test-dependency>
  18.425 +                        <code-name-base>org.netbeans.modules.nbjunit</code-name-base>
  18.426 +                        <compile-dependency/>
  18.427 +                    </test-dependency>
  18.428 +                    <test-dependency>
  18.429 +                        <code-name-base>org.netbeans.modules.parsing.api</code-name-base>
  18.430 +                        <compile-dependency/>
  18.431 +                        <test/>
  18.432 +                    </test-dependency>
  18.433 +                    <test-dependency>
  18.434 +                        <code-name-base>org.netbeans.modules.progress.ui</code-name-base>
  18.435 +                    </test-dependency>
  18.436 +                    <test-dependency>
  18.437 +                        <code-name-base>org.netbeans.modules.projectui</code-name-base>
  18.438 +                    </test-dependency>
  18.439 +                    <test-dependency>
  18.440 +                        <code-name-base>org.openide.util</code-name-base>
  18.441 +                        <compile-dependency/>
  18.442 +                        <test/>
  18.443 +                    </test-dependency>
  18.444 +                    <test-dependency>
  18.445 +                        <code-name-base>org.openide.util.lookup</code-name-base>
  18.446 +                        <compile-dependency/>
  18.447 +                        <test/>
  18.448 +                    </test-dependency>
  18.449 +                </test-type>
  18.450 +            </test-dependencies>
  18.451 +            <public-packages>
  18.452 +                <package>org.netbeans.spi.java.hints</package>
  18.453 +                <package>org.netbeans.spi.java.hints.annotations</package>
  18.454 +                <package>org.netbeans.spi.java.hints.matching</package>
  18.455 +                <package>org.netbeans.spi.java.hints.support</package>
  18.456 +            </public-packages>
  18.457 +        </data>
  18.458 +    </configuration>
  18.459 +</project>

    19.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    19.2 +++ b/java.hints/spi.java.hints/nbproject/suite.properties	Wed May 08 21:47:42 2013 +0200
    19.3 @@ -0,0 +1,1 @@
    19.4 +suite.dir=${basedir}/..

    20.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    20.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/jackpot/spi/Bundle.properties	Wed May 08 21:47:42 2013 +0200
    20.3 @@ -0,0 +1,42 @@
    20.4 +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    20.5 +#
    20.6 +# Copyright 2008-2010 Oracle and/or its affiliates. All rights reserved.
    20.7 +#
    20.8 +# Oracle and Java are registered trademarks of Oracle and/or its affiliates.
    20.9 +# Other names may be trademarks of their respective owners.
   20.10 +#
   20.11 +# The contents of this file are subject to the terms of either the GNU
   20.12 +# General Public License Version 2 only ("GPL") or the Common
   20.13 +# Development and Distribution License("CDDL") (collectively, the
   20.14 +# "License"). You may not use this file except in compliance with the
   20.15 +# License. You can obtain a copy of the License at
   20.16 +# http://www.netbeans.org/cddl-gplv2.html
   20.17 +# or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   20.18 +# specific language governing permissions and limitations under the
   20.19 +# License.  When distributing the software, include this License Header
   20.20 +# Notice in each file and include the License file at
   20.21 +# nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
   20.22 +# particular file as subject to the "Classpath" exception as provided
   20.23 +# by Oracle in the GPL Version 2 section of the License file that
   20.24 +# accompanied this code. If applicable, add the following below the
   20.25 +# License Header, with the fields enclosed by brackets [] replaced by
   20.26 +# your own identifying information:
   20.27 +# "Portions Copyrighted [year] [name of copyright owner]"
   20.28 +#
   20.29 +# Contributor(s):
   20.30 +#
   20.31 +# The Original Software is NetBeans. The Initial Developer of the Original
   20.32 +# Software is Sun Microsystems, Inc. Portions Copyright 2008-2009 Sun
   20.33 +# Microsystems, Inc. All Rights Reserved.
   20.34 +#
   20.35 +# If you wish your version of this file to be governed by only the CDDL
   20.36 +# or only the GPL Version 2, indicate your decision by adding
   20.37 +# "[Contributor] elects to include this software in this distribution
   20.38 +# under the [CDDL or GPL Version 2] license." If you do not indicate a
   20.39 +# single choice of license, a recipient has the option to distribute
   20.40 +# your version of this file under either the CDDL, the GPL Version 2 or
   20.41 +# to extend the choice of license to its licensees as provided above.
   20.42 +# However, if you add GPL Version 2 code and therefore, elected the GPL
   20.43 +# Version 2 license, then the option applies only if the new code is
   20.44 +# made subject to such option by the copyright holder.
   20.45 +LBL_UpdateDependencyQuestion=Update dependency on module {0} to specification version {1}?
   20.46 \ No newline at end of file

    21.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    21.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/jackpot/spi/HintsRunner.java	Wed May 08 21:47:42 2013 +0200
    21.3 @@ -0,0 +1,69 @@
    21.4 +/*
    21.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    21.6 + *
    21.7 + * Copyright 2009-2010 Oracle and/or its affiliates. All rights reserved.
    21.8 + *
    21.9 + * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
   21.10 + * Other names may be trademarks of their respective owners.
   21.11 + *
   21.12 + * The contents of this file are subject to the terms of either the GNU
   21.13 + * General Public License Version 2 only ("GPL") or the Common
   21.14 + * Development and Distribution License("CDDL") (collectively, the
   21.15 + * "License"). You may not use this file except in compliance with the
   21.16 + * License. You can obtain a copy of the License at
   21.17 + * http://www.netbeans.org/cddl-gplv2.html
   21.18 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   21.19 + * specific language governing permissions and limitations under the
   21.20 + * License.  When distributing the software, include this License Header
   21.21 + * Notice in each file and include the License file at
   21.22 + * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
   21.23 + * particular file as subject to the "Classpath" exception as provided
   21.24 + * by Oracle in the GPL Version 2 section of the License file that
   21.25 + * accompanied this code. If applicable, add the following below the
   21.26 + * License Header, with the fields enclosed by brackets [] replaced by
   21.27 + * your own identifying information:
   21.28 + * "Portions Copyrighted [year] [name of copyright owner]"
   21.29 + *
   21.30 + * If you wish your version of this file to be governed by only the CDDL
   21.31 + * or only the GPL Version 2, indicate your decision by adding
   21.32 + * "[Contributor] elects to include this software in this distribution
   21.33 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
   21.34 + * single choice of license, a recipient has the option to distribute
   21.35 + * your version of this file under either the CDDL, the GPL Version 2 or
   21.36 + * to extend the choice of license to its licensees as provided above.
   21.37 + * However, if you add GPL Version 2 code and therefore, elected the GPL
   21.38 + * Version 2 license, then the option applies only if the new code is
   21.39 + * made subject to such option by the copyright holder.
   21.40 + *
   21.41 + * Contributor(s):
   21.42 + *
   21.43 + * Portions Copyrighted 2009-2010 Sun Microsystems, Inc.
   21.44 + */
   21.45 +
   21.46 +package org.netbeans.modules.java.hints.jackpot.spi;
   21.47 +
   21.48 +import org.netbeans.modules.java.hints.providers.spi.HintDescription;
   21.49 +import com.sun.source.util.TreePath;
   21.50 +import java.util.LinkedList;
   21.51 +import java.util.List;
   21.52 +import java.util.Map;
   21.53 +import java.util.concurrent.atomic.AtomicBoolean;
   21.54 +import org.netbeans.api.annotations.common.CheckForNull;
   21.55 +import org.netbeans.api.java.source.CompilationInfo;
   21.56 +import org.netbeans.modules.java.hints.spiimpl.MessageImpl;
   21.57 +import org.netbeans.modules.java.hints.spiimpl.hints.HintsInvoker;
   21.58 +import org.netbeans.modules.java.hints.spiimpl.options.HintsSettings;
   21.59 +import org.netbeans.spi.editor.hints.ErrorDescription;
   21.60 +
   21.61 +/**XXX: probably unused
   21.62 + *
   21.63 + * @author lahvac
   21.64 + */
   21.65 +public class HintsRunner {
   21.66 +
   21.67 +    @CheckForNull
   21.68 +    public static Map<HintDescription, List<ErrorDescription>> computeErrors(CompilationInfo info, Iterable<? extends HintDescription> hints, AtomicBoolean cancel) {
   21.69 +        return new HintsInvoker(HintsSettings.getSettingsFor(info.getFileObject()), cancel).computeHints(info, new TreePath(info.getCompilationUnit()), hints, new LinkedList<MessageImpl>());
   21.70 +    }
   21.71 +
   21.72 +}

    22.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    22.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/jackpot/spi/PatternConvertor.java	Wed May 08 21:47:42 2013 +0200
    22.3 @@ -0,0 +1,113 @@
    22.4 +/*
    22.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    22.6 + *
    22.7 + * Copyright 2009-2011 Sun Microsystems, Inc. All rights reserved.
    22.8 + *
    22.9 + * The contents of this file are subject to the terms of either the GNU
   22.10 + * General Public License Version 2 only ("GPL") or the Common
   22.11 + * Development and Distribution License("CDDL") (collectively, the
   22.12 + * "License"). You may not use this file except in compliance with the
   22.13 + * License. You can obtain a copy of the License at
   22.14 + * http://www.netbeans.org/cddl-gplv2.html
   22.15 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   22.16 + * specific language governing permissions and limitations under the
   22.17 + * License.  When distributing the software, include this License Header
   22.18 + * Notice in each file and include the License file at
   22.19 + * nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this
   22.20 + * particular file as subject to the "Classpath" exception as provided
   22.21 + * by Sun in the GPL Version 2 section of the License file that
   22.22 + * accompanied this code. If applicable, add the following below the
   22.23 + * License Header, with the fields enclosed by brackets [] replaced by
   22.24 + * your own identifying information:
   22.25 + * "Portions Copyrighted [year] [name of copyright owner]"
   22.26 + *
   22.27 + * If you wish your version of this file to be governed by only the CDDL
   22.28 + * or only the GPL Version 2, indicate your decision by adding
   22.29 + * "[Contributor] elects to include this software in this distribution
   22.30 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
   22.31 + * single choice of license, a recipient has the option to distribute
   22.32 + * your version of this file under either the CDDL, the GPL Version 2 or
   22.33 + * to extend the choice of license to its licensees as provided above.
   22.34 + * However, if you add GPL Version 2 code and therefore, elected the GPL
   22.35 + * Version 2 license, then the option applies only if the new code is
   22.36 + * made subject to such option by the copyright holder.
   22.37 + *
   22.38 + * Contributor(s):
   22.39 + *
   22.40 + * Portions Copyrighted 2009-2011 Sun Microsystems, Inc.
   22.41 + */
   22.42 +
   22.43 +package org.netbeans.modules.java.hints.jackpot.spi;
   22.44 +
   22.45 +import org.netbeans.modules.java.hints.providers.spi.HintDescriptionFactory;
   22.46 +import org.netbeans.spi.java.hints.HintContext;
   22.47 +import java.util.ArrayList;
   22.48 +import java.util.Collection;
   22.49 +import java.util.Collections;
   22.50 +import org.netbeans.api.annotations.common.CheckForNull;
   22.51 +import org.netbeans.api.annotations.common.NonNull;
   22.52 +import org.netbeans.modules.java.hints.providers.spi.HintDescription.Worker;
   22.53 +import org.netbeans.modules.java.hints.providers.spi.Trigger.PatternDescription;
   22.54 +import org.netbeans.spi.java.hints.ErrorDescriptionFactory;
   22.55 +import org.netbeans.spi.editor.hints.ErrorDescription;
   22.56 +import org.netbeans.modules.java.hints.providers.spi.HintDescription;
   22.57 +import org.openide.util.Lookup;
   22.58 +
   22.59 +/**XXX: big hack?
   22.60 + *
   22.61 + * @author lahvac
   22.62 + */
   22.63 +public abstract class PatternConvertor {
   22.64 +
   22.65 +    protected abstract @CheckForNull Iterable<? extends HintDescription> parseString(@NonNull String code);
   22.66 +
   22.67 +    public static @CheckForNull Iterable<? extends HintDescription> create(@NonNull String code) {
   22.68 +        Collection<String> patterns = new ArrayList<String>();
   22.69 +        
   22.70 +        //XXX:
   22.71 +        if (code.contains(";;")) {
   22.72 +            PatternConvertor c = Lookup.getDefault().lookup(PatternConvertor.class);
   22.73 +
   22.74 +            if (c != null) {
   22.75 +                return c.parseString(code);
   22.76 +            }
   22.77 +
   22.78 +            for (String s : code.split(";;")) {
   22.79 +                s = s.trim();
   22.80 +                if (s.isEmpty()) {
   22.81 +                    continue;
   22.82 +                }
   22.83 +                
   22.84 +                patterns.add(s);
   22.85 +            }
   22.86 +        } else {
   22.87 +            patterns.add(code);
   22.88 +        }
   22.89 +
   22.90 +        Collection<HintDescription> result = new ArrayList<HintDescription>(patterns.size());
   22.91 +
   22.92 +        for (String pattern : patterns) {
   22.93 +            PatternDescription pd = PatternDescription.create(pattern, Collections.<String, String>emptyMap());
   22.94 +
   22.95 +            HintDescription desc = HintDescriptionFactory.create()
   22.96 +    //                                                     .setDisplayName("Pattern Matches")
   22.97 +                                                         .setTrigger(pd)
   22.98 +                                                         .setWorker(new WorkerImpl())
   22.99 +                                                         .produce();
  22.100 +            
  22.101 +            result.add(desc);
  22.102 +        }
  22.103 +
  22.104 +        return result;
  22.105 +    }
  22.106 +
  22.107 +    private static final class WorkerImpl implements Worker {
  22.108 +
  22.109 +        public Collection<? extends ErrorDescription> createErrors(HintContext ctx) {
  22.110 +            ErrorDescription ed = ErrorDescriptionFactory.forTree(ctx, ctx.getPath(), "Found pattern occurrence");
  22.111 +
  22.112 +            return Collections.singleton(ed);
  22.113 +        }
  22.114 +        
  22.115 +    }
  22.116 +}

    23.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    23.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/jackpot/spi/ProjectDependencyUpgrader.java	Wed May 08 21:47:42 2013 +0200
    23.3 @@ -0,0 +1,64 @@
    23.4 +/*
    23.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    23.6 + *
    23.7 + * Copyright 2010 Sun Microsystems, Inc. All rights reserved.
    23.8 + *
    23.9 + * The contents of this file are subject to the terms of either the GNU
   23.10 + * General Public License Version 2 only ("GPL") or the Common
   23.11 + * Development and Distribution License("CDDL") (collectively, the
   23.12 + * "License"). You may not use this file except in compliance with the
   23.13 + * License. You can obtain a copy of the License at
   23.14 + * http://www.netbeans.org/cddl-gplv2.html
   23.15 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   23.16 + * specific language governing permissions and limitations under the
   23.17 + * License.  When distributing the software, include this License Header
   23.18 + * Notice in each file and include the License file at
   23.19 + * nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this
   23.20 + * particular file as subject to the "Classpath" exception as provided
   23.21 + * by Sun in the GPL Version 2 section of the License file that
   23.22 + * accompanied this code. If applicable, add the following below the
   23.23 + * License Header, with the fields enclosed by brackets [] replaced by
   23.24 + * your own identifying information:
   23.25 + * "Portions Copyrighted [year] [name of copyright owner]"
   23.26 + *
   23.27 + * If you wish your version of this file to be governed by only the CDDL
   23.28 + * or only the GPL Version 2, indicate your decision by adding
   23.29 + * "[Contributor] elects to include this software in this distribution
   23.30 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
   23.31 + * single choice of license, a recipient has the option to distribute
   23.32 + * your version of this file under either the CDDL, the GPL Version 2 or
   23.33 + * to extend the choice of license to its licensees as provided above.
   23.34 + * However, if you add GPL Version 2 code and therefore, elected the GPL
   23.35 + * Version 2 license, then the option applies only if the new code is
   23.36 + * made subject to such option by the copyright holder.
   23.37 + *
   23.38 + * Contributor(s):
   23.39 + *
   23.40 + * Portions Copyrighted 2010 Sun Microsystems, Inc.
   23.41 + */
   23.42 +package org.netbeans.modules.java.hints.jackpot.spi;
   23.43 +
   23.44 +import org.netbeans.api.project.Project;
   23.45 +import org.openide.DialogDisplayer;
   23.46 +import org.openide.NotifyDescriptor;
   23.47 +import org.openide.filesystems.FileObject;
   23.48 +import org.openide.modules.SpecificationVersion;
   23.49 +
   23.50 +/**
   23.51 + *
   23.52 + * @author lahvac
   23.53 + */
   23.54 +public abstract class ProjectDependencyUpgrader {
   23.55 +
   23.56 +    public abstract boolean ensureDependency(Project p, FileObject dep, SpecificationVersion spec, boolean canShowUI);
   23.57 +    public abstract boolean ensureDependency(Project p, String specification, boolean b);
   23.58 +
   23.59 +    protected final boolean showDependencyUpgradeDialog(Project p, String dep, SpecificationVersion currentDependency, SpecificationVersion spec, boolean newDepenency, boolean canShowUI) {
   23.60 +        if (!canShowUI) return true;
   23.61 +        
   23.62 +        NotifyDescriptor nd = new NotifyDescriptor.Confirmation("New version: " + spec, "Update spec version.", NotifyDescriptor.YES_NO_OPTION);
   23.63 +
   23.64 +        return DialogDisplayer.getDefault().notify(nd) == NotifyDescriptor.YES_OPTION;
   23.65 +    }
   23.66 +
   23.67 +}

    24.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    24.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/providers/code/CodeHintProviderImpl.java	Wed May 08 21:47:42 2013 +0200
    24.3 @@ -0,0 +1,456 @@
    24.4 +/*
    24.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    24.6 + *
    24.7 + * Copyright 2008-2010 Oracle and/or its affiliates. All rights reserved.
    24.8 + *
    24.9 + * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
   24.10 + * Other names may be trademarks of their respective owners.
   24.11 + *
   24.12 + * The contents of this file are subject to the terms of either the GNU
   24.13 + * General Public License Version 2 only ("GPL") or the Common
   24.14 + * Development and Distribution License("CDDL") (collectively, the
   24.15 + * "License"). You may not use this file except in compliance with the
   24.16 + * License. You can obtain a copy of the License at
   24.17 + * http://www.netbeans.org/cddl-gplv2.html
   24.18 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   24.19 + * specific language governing permissions and limitations under the
   24.20 + * License.  When distributing the software, include this License Header
   24.21 + * Notice in each file and include the License file at
   24.22 + * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
   24.23 + * particular file as subject to the "Classpath" exception as provided
   24.24 + * by Oracle in the GPL Version 2 section of the License file that
   24.25 + * accompanied this code. If applicable, add the following below the
   24.26 + * License Header, with the fields enclosed by brackets [] replaced by
   24.27 + * your own identifying information:
   24.28 + * "Portions Copyrighted [year] [name of copyright owner]"
   24.29 + *
   24.30 + * If you wish your version of this file to be governed by only the CDDL
   24.31 + * or only the GPL Version 2, indicate your decision by adding
   24.32 + * "[Contributor] elects to include this software in this distribution
   24.33 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
   24.34 + * single choice of license, a recipient has the option to distribute
   24.35 + * your version of this file under either the CDDL, the GPL Version 2 or
   24.36 + * to extend the choice of license to its licensees as provided above.
   24.37 + * However, if you add GPL Version 2 code and therefore, elected the GPL
   24.38 + * Version 2 license, then the option applies only if the new code is
   24.39 + * made subject to such option by the copyright holder.
   24.40 + *
   24.41 + * Contributor(s):
   24.42 + *
   24.43 + * Portions Copyrighted 2008-2010 Sun Microsystems, Inc.
   24.44 + */
   24.45 +
   24.46 +package org.netbeans.modules.java.hints.providers.code;
   24.47 +
   24.48 +import com.sun.source.tree.Tree.Kind;
   24.49 +import java.lang.annotation.Annotation;
   24.50 +import java.lang.reflect.InvocationTargetException;
   24.51 +import java.lang.reflect.Method;
   24.52 +import java.util.ArrayList;
   24.53 +import java.util.Arrays;
   24.54 +import java.util.Collection;
   24.55 +import java.util.Collections;
   24.56 +import java.util.EnumSet;
   24.57 +import java.util.HashMap;
   24.58 +import java.util.HashSet;
   24.59 +import java.util.LinkedList;
   24.60 +import java.util.List;
   24.61 +import java.util.Map;
   24.62 +import java.util.Set;
   24.63 +import java.util.concurrent.atomic.AtomicReference;
   24.64 +import java.util.logging.Level;
   24.65 +import java.util.logging.Logger;
   24.66 +import java.util.prefs.Preferences;
   24.67 +import javax.swing.JComponent;
   24.68 +import javax.swing.JPanel;
   24.69 +import org.netbeans.modules.java.hints.providers.code.FSWrapper.ClassWrapper;
   24.70 +import org.netbeans.modules.java.hints.providers.code.FSWrapper.FieldWrapper;
   24.71 +import org.netbeans.modules.java.hints.providers.code.FSWrapper.MethodWrapper;
   24.72 +import org.netbeans.modules.java.hints.providers.code.ReflectiveCustomizerProvider.OptionDescriptor;
   24.73 +import org.netbeans.spi.java.hints.CustomizerProvider;
   24.74 +import org.netbeans.modules.java.hints.providers.spi.HintDescription;
   24.75 +import org.netbeans.modules.java.hints.providers.spi.HintDescription.Worker;
   24.76 +import org.netbeans.modules.java.hints.providers.spi.HintDescriptionFactory;
   24.77 +import org.netbeans.modules.java.hints.providers.spi.HintMetadata;
   24.78 +import org.netbeans.modules.java.hints.providers.spi.HintMetadata.Options;
   24.79 +import org.netbeans.modules.java.hints.providers.spi.HintProvider;
   24.80 +import org.netbeans.modules.java.hints.providers.spi.Trigger.Kinds;
   24.81 +import org.netbeans.modules.java.hints.providers.spi.Trigger.PatternDescription;
   24.82 +import org.netbeans.spi.editor.hints.ErrorDescription;
   24.83 +import org.netbeans.spi.editor.hints.Severity;
   24.84 +import org.netbeans.spi.java.hints.BooleanOption;
   24.85 +import org.netbeans.spi.java.hints.ConstraintVariableType;
   24.86 +import org.netbeans.spi.java.hints.Hint;
   24.87 +import org.netbeans.spi.java.hints.IntegerOption;
   24.88 +import org.netbeans.spi.java.hints.TriggerPattern;
   24.89 +import org.netbeans.spi.java.hints.TriggerPatterns;
   24.90 +import org.netbeans.spi.java.hints.TriggerTreeKind;
   24.91 +import org.netbeans.spi.java.hints.UseOptions;
   24.92 +import org.openide.util.Exceptions;
   24.93 +import org.openide.util.Lookup;
   24.94 +import org.openide.util.NbCollections;
   24.95 +import org.openide.util.lookup.ServiceProvider;
   24.96 +
   24.97 +/**
   24.98 + *
   24.99 + * @author lahvac
  24.100 + */
  24.101 +@ServiceProvider(service=HintProvider.class)
  24.102 +public class CodeHintProviderImpl implements HintProvider {
  24.103 +
  24.104 +    private static final Logger LOG = Logger.getLogger(WorkerImpl.class.getName());
  24.105 +    
  24.106 +    public Map<HintMetadata, ? extends Collection<? extends HintDescription>> computeHints() {
  24.107 +        return computeHints(findLoader(), "META-INF/nb-hints/hints");
  24.108 +    }
  24.109 +
  24.110 +    private Map<HintMetadata, ? extends Collection<? extends HintDescription>> computeHints(ClassLoader l, String path) {
  24.111 +        Map<HintMetadata, Collection<HintDescription>> result = new HashMap<HintMetadata, Collection<HintDescription>>();
  24.112 +        
  24.113 +        for (ClassWrapper c : FSWrapper.listClasses()) {
  24.114 +            try {
  24.115 +                processClass(c, result);
  24.116 +            } catch (ThreadDeath td) {
  24.117 +                throw td;
  24.118 +            } catch (Throwable t) {
  24.119 +                Exceptions.printStackTrace(t);
  24.120 +            }
  24.121 +        }
  24.122 +
  24.123 +        return result;
  24.124 +    }
  24.125 +
  24.126 +    static ClassLoader findLoader() {
  24.127 +        ClassLoader l = Lookup.getDefault().lookup(ClassLoader.class);
  24.128 +
  24.129 +        if (l == null) {
  24.130 +            return CodeHintProviderImpl.class.getClassLoader();
  24.131 +        }
  24.132 +
  24.133 +        return l;
  24.134 +    }
  24.135 +
  24.136 +    public static void processClass(ClassWrapper clazz, Map<HintMetadata, Collection<HintDescription>> result) throws SecurityException {
  24.137 +        Hint metadata = clazz.getAnnotation(Hint.class);
  24.138 +        HintMetadata hm;
  24.139 +        
  24.140 +        if (metadata != null) {
  24.141 +            String id = metadata.id();
  24.142 +
  24.143 +            if (id == null || id.length() == 0) {
  24.144 +                id = clazz.getName();
  24.145 +            }
  24.146 +            hm = fromAnnotation(id, clazz, null, metadata);
  24.147 +        } else {
  24.148 +            hm = null;
  24.149 +        }
  24.150 +        
  24.151 +        for (MethodWrapper m : clazz.getMethods()) {
  24.152 +            Hint localMetadataAnnotation = m.getAnnotation(Hint.class);
  24.153 +            HintMetadata localMetadata;
  24.154 +
  24.155 +            if (localMetadataAnnotation != null) {
  24.156 +                String localID = localMetadataAnnotation.id();
  24.157 +
  24.158 +                if (localID == null || localID.length() == 0) {
  24.159 +                    localID = clazz.getName() + "." + m.getName();
  24.160 +                }
  24.161 +
  24.162 +                localMetadata = fromAnnotation(localID, clazz, m, localMetadataAnnotation);
  24.163 +            } else {
  24.164 +                localMetadata = hm;
  24.165 +            }
  24.166 +
  24.167 +            if (localMetadata != null) {
  24.168 +                processMethod(result, m, localMetadata);
  24.169 +            }
  24.170 +        }
  24.171 +    }
  24.172 +
  24.173 +    private static HintMetadata fromAnnotation(String id, ClassWrapper clazz, MethodWrapper method, Hint metadata) {
  24.174 +        HintMetadata hm = HintMetadata.Builder.create(id)
  24.175 +                                              .setDescription(metadata.displayName(), metadata.description())
  24.176 +                                              .setCategory(metadata.category())
  24.177 +                                              .setEnabled(metadata.enabled())
  24.178 +                                              .setSeverity(metadata.severity())
  24.179 +                                              .setKind(metadata.hintKind())
  24.180 +                                              .setCustomizerProvider(createCustomizerProvider(clazz, method, id, metadata))
  24.181 +                                              .addSuppressWarnings(metadata.suppressWarnings())
  24.182 +                                              .addOptions(Options.fromHintOptions(metadata.options()).toArray(new Options[0]))
  24.183 +                                              .build();
  24.184 +        return hm;
  24.185 +    }
  24.186 +
  24.187 +    private static CustomizerProvider createCustomizerProvider(ClassWrapper clazz, MethodWrapper method, String id, Hint hint) {
  24.188 +        Class<? extends CustomizerProvider> customizerClass = hint.customizerProvider();
  24.189 +
  24.190 +        if (customizerClass != CustomizerProvider.class) {
  24.191 +            return new DelegatingCustomizerProvider(customizerClass);
  24.192 +        }
  24.193 +
  24.194 +        Set<String> allowedOptions = null;
  24.195 +
  24.196 +        if (method != null) {
  24.197 +            UseOptions useOptions = method.getAnnotation(UseOptions.class);
  24.198 +
  24.199 +            if (useOptions == null) return null;
  24.200 +
  24.201 +            allowedOptions = new HashSet<String>(Arrays.asList(useOptions.value()));
  24.202 +        }
  24.203 +
  24.204 +        List<OptionDescriptor> declarativeOptions = new ArrayList<OptionDescriptor>();
  24.205 +
  24.206 +        for (FieldWrapper fw : clazz.getFields()) {
  24.207 +            BooleanOption option = fw.getAnnotation(BooleanOption.class);
  24.208 +            IntegerOption iOption = fw.getAnnotation(IntegerOption.class);
  24.209 +            
  24.210 +            String key = fw.getConstantValue();
  24.211 +
  24.212 +            if (key == null) continue;
  24.213 +            if (allowedOptions != null && !allowedOptions.contains(key)) continue;
  24.214 +            
  24.215 +            Object defValue;
  24.216 +            String displayName;
  24.217 +            String tooltip;
  24.218 +            if (option != null) {
  24.219 +                defValue = option.defaultValue();
  24.220 +                displayName = option.displayName();
  24.221 +                tooltip = option.tooltip();
  24.222 +            } else if (iOption != null) {
  24.223 +                defValue = iOption.defaultValue();
  24.224 +                displayName = iOption.displayName();
  24.225 +                tooltip = iOption.tooltip();
  24.226 +            } else {
  24.227 +                return null;
  24.228 +            }
  24.229 +            
  24.230 +            declarativeOptions.add(
  24.231 +                new OptionDescriptor(
  24.232 +                    key, 
  24.233 +                    defValue,
  24.234 +                    displayName,
  24.235 +                    tooltip,
  24.236 +                    option != null ? option : iOption)
  24.237 +            );
  24.238 +        }
  24.239 +
  24.240 +        return !declarativeOptions.isEmpty() ? new ReflectiveCustomizerProvider(clazz.getName(), id, declarativeOptions) : null;
  24.241 +    }
  24.242 +    
  24.243 +    static void processMethod(Map<HintMetadata, Collection<HintDescription>> hints, MethodWrapper m, HintMetadata metadata) {
  24.244 +        //XXX: combinations of TriggerTreeKind and TriggerPattern?
  24.245 +        processTreeKindHint(hints, m, metadata);
  24.246 +        processPatternHint(hints, m, metadata);
  24.247 +    }
  24.248 +    
  24.249 +    private static void processTreeKindHint(Map<HintMetadata, Collection<HintDescription>> hints, MethodWrapper m, HintMetadata metadata) {
  24.250 +        TriggerTreeKind kindTrigger = m.getAnnotation(TriggerTreeKind.class);
  24.251 +
  24.252 +        if (kindTrigger == null) {
  24.253 +            return ;
  24.254 +        }
  24.255 +
  24.256 +        Worker w = new WorkerImpl(m.getClazz().getName(), m.getName());
  24.257 +
  24.258 +        Set<Kind> kinds = EnumSet.noneOf(Kind.class);
  24.259 +        
  24.260 +        kinds.addAll(Arrays.asList(kindTrigger.value()));
  24.261 +
  24.262 +        addHint(hints, metadata, HintDescriptionFactory.create()
  24.263 +                                                       .setTrigger(new Kinds(kinds))
  24.264 +                                                       .setWorker(w)
  24.265 +                                                       .setMetadata(metadata)
  24.266 +                                                       .produce());
  24.267 +    }
  24.268 +    
  24.269 +    private static void processPatternHint(Map<HintMetadata, Collection<HintDescription>> hints, MethodWrapper m, HintMetadata metadata) {
  24.270 +        TriggerPattern patternTrigger = m.getAnnotation(TriggerPattern.class);
  24.271 +
  24.272 +        if (patternTrigger != null) {
  24.273 +            processPatternHint(hints, patternTrigger, m, metadata);
  24.274 +            return ;
  24.275 +        }
  24.276 +
  24.277 +        TriggerPatterns patternTriggers = m.getAnnotation(TriggerPatterns.class);
  24.278 +
  24.279 +        if (patternTriggers != null) {
  24.280 +            for (TriggerPattern pattern : patternTriggers.value()) {
  24.281 +                processPatternHint(hints, pattern, m, metadata);
  24.282 +            }
  24.283 +            return ;
  24.284 +        }
  24.285 +    }
  24.286 +
  24.287 +    private static void processPatternHint(Map<HintMetadata, Collection<HintDescription>> hints, TriggerPattern patternTrigger, MethodWrapper m, HintMetadata metadata) {
  24.288 +        String pattern = patternTrigger.value();
  24.289 +        Map<String, String> constraints = new HashMap<String, String>();
  24.290 +
  24.291 +        for (ConstraintVariableType c : patternTrigger.constraints()) {
  24.292 +            constraints.put(c.variable(), c.type());
  24.293 +        }
  24.294 +
  24.295 +        PatternDescription pd = PatternDescription.create(pattern, constraints);
  24.296 +
  24.297 +        addHint(hints, metadata, HintDescriptionFactory.create()
  24.298 +                                                       .setTrigger(pd)
  24.299 +                                                       .setWorker(new WorkerImpl(m.getClazz().getName(), m.getName()))
  24.300 +                                                       .setMetadata(metadata)
  24.301 +                                                       .produce());
  24.302 +    }
  24.303 +
  24.304 +    private static void addHint(Map<HintMetadata, Collection<HintDescription>> hints, HintMetadata metadata, HintDescription hint) {
  24.305 +        Collection<HintDescription> list = hints.get(metadata);
  24.306 +
  24.307 +        if (list == null) {
  24.308 +            hints.put(metadata, list = new LinkedList<HintDescription>());
  24.309 +        }
  24.310 +
  24.311 +        list.add(hint);
  24.312 +    }
  24.313 +
  24.314 +    //accessed by tests:
  24.315 +    static final class WorkerImpl implements Worker {
  24.316 +
  24.317 +        private final String className;
  24.318 +        private final String methodName;
  24.319 +
  24.320 +        public WorkerImpl(String className, String methodName) {
  24.321 +            this.className = className;
  24.322 +            this.methodName = methodName;
  24.323 +        }
  24.324 +
  24.325 +        private final AtomicReference<Method> methodRef = new AtomicReference<Method>();
  24.326 +
  24.327 +        public Collection<? extends ErrorDescription> createErrors(org.netbeans.spi.java.hints.HintContext ctx) {
  24.328 +            try {
  24.329 +                Method method = methodRef.get();
  24.330 +
  24.331 +                if (method == null) {
  24.332 +                    methodRef.set(method = getMethod());
  24.333 +                }
  24.334 +                
  24.335 +                Object result = method.invoke(null, ctx);
  24.336 +
  24.337 +                if (result == null) {
  24.338 +                    return null;
  24.339 +                }
  24.340 +
  24.341 +                if (result instanceof Iterable) {
  24.342 +                    List<ErrorDescription> out = new LinkedList<ErrorDescription>();
  24.343 +
  24.344 +                    for (ErrorDescription ed : NbCollections.iterable(NbCollections.checkedIteratorByFilter(((Iterable) result).iterator(), ErrorDescription.class, false))) {
  24.345 +                        out.add(ed);
  24.346 +                    }
  24.347 +
  24.348 +                    return out;
  24.349 +                }
  24.350 +
  24.351 +                if (result instanceof ErrorDescription) {
  24.352 +                    return Collections.singletonList((ErrorDescription) result);
  24.353 +                }
  24.354 +
  24.355 +                //XXX: log if result was ignored...
  24.356 +            } catch (IllegalAccessException ex) {
  24.357 +                Exceptions.printStackTrace(ex);
  24.358 +            } catch (IllegalArgumentException ex) {
  24.359 +                Exceptions.printStackTrace(ex);
  24.360 +            } catch (ClassNotFoundException ex) {
  24.361 +                Exceptions.printStackTrace(ex);
  24.362 +            } catch (NoSuchMethodException ex) {
  24.363 +                Exceptions.printStackTrace(ex);
  24.364 +            } catch (InvocationTargetException ex) {
  24.365 +                LOG.log(Level.INFO, className + "." + methodName, ex);
  24.366 +                //so that the exceptions are categorized better:
  24.367 +                Exceptions.printStackTrace(ex.getCause());
  24.368 +            }
  24.369 +
  24.370 +            return null;
  24.371 +        }
  24.372 +
  24.373 +        //used by tests:
  24.374 +        Method getMethod() throws NoSuchMethodException, ClassNotFoundException {
  24.375 +            return FSWrapper.resolveMethod(className, methodName);
  24.376 +        }
  24.377 +
  24.378 +    }
  24.379 +
  24.380 +    private static final class EmptyHintMetadataDescription implements Hint {
  24.381 +
  24.382 +        public String id() {
  24.383 +            return "";
  24.384 +        }
  24.385 +
  24.386 +        public String category() {
  24.387 +            return "general";
  24.388 +        }
  24.389 +
  24.390 +        public boolean enabled() {
  24.391 +            return true;
  24.392 +        }
  24.393 +
  24.394 +        public Severity severity() {
  24.395 +            return Severity.VERIFIER;
  24.396 +        }
  24.397 +
  24.398 +        private static final String[] EMPTY_SW = new String[0];
  24.399 +        
  24.400 +        public String[] suppressWarnings() {
  24.401 +            return EMPTY_SW;
  24.402 +        }
  24.403 +
  24.404 +        public Class<? extends Annotation> annotationType() {
  24.405 +            return Hint.class;
  24.406 +        }
  24.407 +
  24.408 +        public Class<? extends CustomizerProvider> customizerProvider() {
  24.409 +            return CustomizerProvider.class;
  24.410 +        }
  24.411 +
  24.412 +        public Kind hintKind() {
  24.413 +            return Kind.INSPECTION;
  24.414 +        }
  24.415 +
  24.416 +        private static final Options[] EMPTY_OPTIONS = new Options[0];
  24.417 +
  24.418 +        public Options[] options() {
  24.419 +            return EMPTY_OPTIONS;
  24.420 +        }
  24.421 +
  24.422 +        @Override public String displayName() {
  24.423 +            return "";
  24.424 +        }
  24.425 +
  24.426 +        @Override public String description() {
  24.427 +            return "";
  24.428 +        }
  24.429 +
  24.430 +    }
  24.431 +
  24.432 +    private static final class DelegatingCustomizerProvider implements CustomizerProvider {
  24.433 +
  24.434 +        private final Class<? extends CustomizerProvider> component;
  24.435 +
  24.436 +        public DelegatingCustomizerProvider(Class<? extends CustomizerProvider> component) {
  24.437 +            this.component = component;
  24.438 +        }
  24.439 +
  24.440 +        @Override
  24.441 +        public JComponent getCustomizer(Preferences prefs) {
  24.442 +            try {
  24.443 +                return component.newInstance().getCustomizer(prefs);
  24.444 +            } catch (SecurityException ex) {
  24.445 +                Exceptions.printStackTrace(ex);
  24.446 +            } catch (InstantiationException ex) {
  24.447 +                Exceptions.printStackTrace(ex);
  24.448 +            } catch (IllegalAccessException ex) {
  24.449 +                Exceptions.printStackTrace(ex);
  24.450 +            } catch (IllegalArgumentException ex) {
  24.451 +                Exceptions.printStackTrace(ex);
  24.452 +            }
  24.453 +
  24.454 +            return new JPanel();
  24.455 +        }
  24.456 +
  24.457 +    }
  24.458 +
  24.459 +}

    25.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    25.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/providers/code/FSWrapper.java	Wed May 08 21:47:42 2013 +0200
    25.3 @@ -0,0 +1,319 @@
    25.4 +/*
    25.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    25.6 + *
    25.7 + * Copyright 2010-2011 Oracle and/or its affiliates. All rights reserved.
    25.8 + *
    25.9 + * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
   25.10 + * Other names may be trademarks of their respective owners.
   25.11 + *
   25.12 + * The contents of this file are subject to the terms of either the GNU
   25.13 + * General Public License Version 2 only ("GPL") or the Common
   25.14 + * Development and Distribution License("CDDL") (collectively, the
   25.15 + * "License"). You may not use this file except in compliance with the
   25.16 + * License. You can obtain a copy of the License at
   25.17 + * http://www.netbeans.org/cddl-gplv2.html
   25.18 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   25.19 + * specific language governing permissions and limitations under the
   25.20 + * License.  When distributing the software, include this License Header
   25.21 + * Notice in each file and include the License file at
   25.22 + * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
   25.23 + * particular file as subject to the "Classpath" exception as provided
   25.24 + * by Oracle in the GPL Version 2 section of the License file that
   25.25 + * accompanied this code. If applicable, add the following below the
   25.26 + * License Header, with the fields enclosed by brackets [] replaced by
   25.27 + * your own identifying information:
   25.28 + * "Portions Copyrighted [year] [name of copyright owner]"
   25.29 + *
   25.30 + * If you wish your version of this file to be governed by only the CDDL
   25.31 + * or only the GPL Version 2, indicate your decision by adding
   25.32 + * "[Contributor] elects to include this software in this distribution
   25.33 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
   25.34 + * single choice of license, a recipient has the option to distribute
   25.35 + * your version of this file under either the CDDL, the GPL Version 2 or
   25.36 + * to extend the choice of license to its licensees as provided above.
   25.37 + * However, if you add GPL Version 2 code and therefore, elected the GPL
   25.38 + * Version 2 license, then the option applies only if the new code is
   25.39 + * made subject to such option by the copyright holder.
   25.40 + *
   25.41 + * Contributor(s):
   25.42 + *
   25.43 + * Portions Copyrighted 2010-2011 Sun Microsystems, Inc.
   25.44 + */
   25.45 +
   25.46 +package org.netbeans.modules.java.hints.providers.code;
   25.47 +
   25.48 +import java.lang.annotation.Annotation;
   25.49 +import java.lang.reflect.Array;
   25.50 +import java.lang.reflect.InvocationHandler;
   25.51 +import java.lang.reflect.Method;
   25.52 +import java.lang.reflect.Proxy;
   25.53 +import java.util.HashMap;
   25.54 +import java.util.LinkedList;
   25.55 +import java.util.List;
   25.56 +import java.util.Map;
   25.57 +import java.util.logging.Level;
   25.58 +import java.util.logging.Logger;
   25.59 +import org.netbeans.spi.java.hints.HintContext;
   25.60 +import org.openide.filesystems.FileObject;
   25.61 +import org.openide.filesystems.FileUtil;
   25.62 +import org.openide.util.Exceptions;
   25.63 +
   25.64 +/**
   25.65 + *
   25.66 + * @author lahvac
   25.67 + */
   25.68 +public class FSWrapper {
   25.69 +
   25.70 +    public static Iterable<? extends ClassWrapper> listClasses() {
   25.71 +        ClassLoader loader = FSWrapper.class.getClassLoader();
   25.72 +
   25.73 +        if (loader == null) {
   25.74 +            loader = ClassLoader.getSystemClassLoader();
   25.75 +        }
   25.76 +
   25.77 +        List<ClassWrapper> result = new LinkedList<ClassWrapper>();
   25.78 +        FileObject main = FileUtil.getConfigFile("org-netbeans-modules-java-hints/code-hints/");
   25.79 +
   25.80 +        if (main != null) {
   25.81 +            for (FileObject c : main.getChildren()) {
   25.82 +                result.add(new ClassWrapper(loader, c));
   25.83 +            }
   25.84 +        }
   25.85 +
   25.86 +        return result;
   25.87 +    }
   25.88 +
   25.89 +    public static Method resolveMethod(String className, String methodName) throws NoSuchMethodException, ClassNotFoundException {
   25.90 +        Class<?> clazz = CodeHintProviderImpl.findLoader().loadClass(className);
   25.91 +
   25.92 +        return clazz.getDeclaredMethod(methodName, HintContext.class);
   25.93 +    }
   25.94 +
   25.95 +    public static class AnnotatableWrapper {
   25.96 +        protected final ClassLoader loader;
   25.97 +        protected final FileObject folder;
   25.98 +        protected AnnotatableWrapper(ClassLoader loader, FileObject folder) {
   25.99 +            this.loader = loader;
  25.100 +            this.folder = folder;
  25.101 +        }
  25.102 +
  25.103 +        private final Map<Class<? extends Annotation>, Annotation> annotations = new HashMap<Class<? extends Annotation>, Annotation>();
  25.104 +
  25.105 +        public synchronized <T extends Annotation> T getAnnotation(Class<T> annotationClass) {
  25.106 +            if (!this.annotations.containsKey(annotationClass)) {
  25.107 +                FileObject f = folder.getFileObject(annotationClass.getName().replace('.', '-') + ".annotation");
  25.108 +                T result = null;
  25.109 +
  25.110 +                if (f != null) {
  25.111 +                    try {
  25.112 +                        Annotation a = loadAnnotation(loader, f);
  25.113 +
  25.114 +                        result = annotationClass.cast(a);
  25.115 +                    } catch (ClassNotFoundException ex) {
  25.116 +                        Exceptions.printStackTrace(ex);
  25.117 +                    }
  25.118 +                }
  25.119 +
  25.120 +                this.annotations.put(annotationClass, result);
  25.121 +            }
  25.122 +
  25.123 +            return annotationClass.cast(this.annotations.get(annotationClass));
  25.124 +        }
  25.125 +    }
  25.126 +
  25.127 +    public static class ClassWrapper extends AnnotatableWrapper {
  25.128 +        private final String className;
  25.129 +        public ClassWrapper(ClassLoader loader, FileObject folder) {
  25.130 +            super(loader, folder);
  25.131 +            className = folder.getName().replace('-', '.');
  25.132 +        }
  25.133 +
  25.134 +        private Iterable<? extends MethodWrapper> methods;
  25.135 +
  25.136 +        public synchronized Iterable<? extends MethodWrapper> getMethods() {
  25.137 +            if (this.methods == null) {
  25.138 +                List<MethodWrapper> methods = new LinkedList<MethodWrapper>();
  25.139 +
  25.140 +                for (FileObject c : folder.getChildren()) {
  25.141 +                    if (c.getExt().equals("method")) {
  25.142 +                        methods.add(new MethodWrapper(loader, c, this));
  25.143 +                    }
  25.144 +                }
  25.145 +
  25.146 +                this.methods = methods;
  25.147 +            }
  25.148 +
  25.149 +            return this.methods;
  25.150 +        }
  25.151 +
  25.152 +        private Iterable<? extends FieldWrapper> fields;
  25.153 +
  25.154 +        public synchronized Iterable<? extends FieldWrapper> getFields() {
  25.155 +            if (this.fields == null) {
  25.156 +                List<FieldWrapper> fields = new LinkedList<FieldWrapper>();
  25.157 +
  25.158 +                for (FileObject c : folder.getChildren()) {
  25.159 +                    if (c.getExt().equals("field")) {
  25.160 +                        fields.add(new FieldWrapper(loader, c, this));
  25.161 +                    }
  25.162 +                }
  25.163 +
  25.164 +                this.fields = fields;
  25.165 +            }
  25.166 +
  25.167 +            return this.fields;
  25.168 +        }
  25.169 +
  25.170 +        public String getName() {
  25.171 +            return className;
  25.172 +        }
  25.173 +
  25.174 +        private Class<?> clazz;
  25.175 +        public synchronized Class<?> getDeclaredClass() {
  25.176 +            if (clazz != null) {
  25.177 +                return clazz;
  25.178 +            }
  25.179 +
  25.180 +            try {
  25.181 +                return this.clazz = loader.loadClass(className);
  25.182 +            } catch (ClassNotFoundException ex) {
  25.183 +                Exceptions.printStackTrace(ex);
  25.184 +            }
  25.185 +
  25.186 +            return null; //XXX
  25.187 +        }
  25.188 +    }
  25.189 +
  25.190 +    public static class MethodWrapper extends AnnotatableWrapper {
  25.191 +        private final ClassWrapper clazz;
  25.192 +        public MethodWrapper(ClassLoader loader, FileObject folder, ClassWrapper clazz) {
  25.193 +            super(loader, folder);
  25.194 +            this.clazz = clazz;
  25.195 +        }
  25.196 +
  25.197 +        ClassWrapper getClazz() {
  25.198 +            return clazz;
  25.199 +        }
  25.200 +        
  25.201 +        String getName() {
  25.202 +            return folder.getName();
  25.203 +        }
  25.204 +    }
  25.205 +
  25.206 +    public static class FieldWrapper extends AnnotatableWrapper {
  25.207 +        private final ClassWrapper clazz;
  25.208 +        public FieldWrapper(ClassLoader loader, FileObject folder, ClassWrapper clazz) {
  25.209 +            super(loader, folder);
  25.210 +            this.clazz = clazz;
  25.211 +        }
  25.212 +
  25.213 +        ClassWrapper getClazz() {
  25.214 +            return clazz;
  25.215 +        }
  25.216 +
  25.217 +        String getName() {
  25.218 +            return folder.getName();
  25.219 +        }
  25.220 +
  25.221 +        String getConstantValue() {
  25.222 +            Object constantValue = folder.getAttribute("constantValue");
  25.223 +
  25.224 +            if (constantValue instanceof String) {
  25.225 +                return (String) constantValue;
  25.226 +            }
  25.227 +
  25.228 +            return null;
  25.229 +        }
  25.230 +    }
  25.231 +
  25.232 +    private static final Object MARKER = new Object();
  25.233 +    
  25.234 +    private static Object computeAttributeValue(ClassLoader loader, FileObject folder, String attributeName, Class<?> returnType, Object defaulValue) throws ClassNotFoundException {
  25.235 +        Object result = folder.getAttribute(attributeName);
  25.236 +
  25.237 +        if (result == null) {
  25.238 +            FileObject embedded = folder.getFileObject(attributeName);
  25.239 +
  25.240 +            if (embedded == null) {
  25.241 +                result = defaulValue;
  25.242 +            } else {
  25.243 +                if (returnType.isArray()) {
  25.244 +                    List<Object> items = new LinkedList<Object>();
  25.245 +                    int c = 0;
  25.246 +
  25.247 +                    while (true) {
  25.248 +                        Object val = computeAttributeValue(loader, embedded, "item" + c, returnType.getComponentType(), MARKER);
  25.249 +
  25.250 +                        if (val == MARKER) {
  25.251 +                            break;
  25.252 +                        }
  25.253 +
  25.254 +                        items.add(val);
  25.255 +                        c++;
  25.256 +                    }
  25.257 +
  25.258 +                    Object res = Array.newInstance(returnType.getComponentType(), items.size());
  25.259 +                    int ci = 0;
  25.260 +
  25.261 +                    for (Object i : items) {
  25.262 +                        Array.set(res, ci++, i);
  25.263 +                    }
  25.264 +
  25.265 +                    result = res;
  25.266 +                } else if (returnType.isAnnotation()) {
  25.267 +                    result = loadAnnotation(loader, embedded.getChildren()[0]);
  25.268 +                }
  25.269 +            }
  25.270 +        } else {
  25.271 +            if (returnType.isEnum()) {
  25.272 +                String fqn = (String) result;
  25.273 +                int lastDot = fqn.lastIndexOf('.');
  25.274 +                Class<? extends Enum> enumClass = (Class<? extends Enum>) loader.loadClass(fqn.substring(0, lastDot));
  25.275 +
  25.276 +                result = Enum.valueOf(enumClass, fqn.substring(lastDot + 1));
  25.277 +            } else if (returnType == Class.class) {
  25.278 +                String fqn = (String) result;
  25.279 +
  25.280 +                try {
  25.281 +                    result = loader.loadClass(fqn);
  25.282 +                } catch (ClassNotFoundException ex) {
  25.283 +                    Logger.getLogger(FSWrapper.class.getName()).log(Level.FINE, null, ex);
  25.284 +                    result = CodeHintProviderImpl.findLoader().loadClass(fqn);
  25.285 +                }
  25.286 +            }
  25.287 +        }
  25.288 +
  25.289 +        return result;
  25.290 +    }
  25.291 +
  25.292 +    
  25.293 +    private static <T extends Annotation> T loadAnnotation(ClassLoader l, FileObject annotationFolder) throws ClassNotFoundException {
  25.294 +        Class<?> clazz = l.loadClass(annotationFolder.getName().replace('-', '.'));
  25.295 +
  25.296 +        return (T) Proxy.newProxyInstance(l, new Class[] {clazz}, new InvocationHandlerImpl(l, annotationFolder));
  25.297 +    }
  25.298 +    
  25.299 +    private static final class InvocationHandlerImpl implements InvocationHandler {
  25.300 +
  25.301 +        private final ClassLoader loader;
  25.302 +        private final FileObject folder;
  25.303 +        private final Map<String, Object> attributes = new HashMap<String, Object>();
  25.304 +
  25.305 +        public InvocationHandlerImpl(ClassLoader loader, FileObject folder) {
  25.306 +            this.loader = loader;
  25.307 +            this.folder = folder;
  25.308 +        }
  25.309 +
  25.310 +        public synchronized Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
  25.311 +            if (!attributes.containsKey(method.getName())) {
  25.312 +                Object result = computeAttributeValue(loader, folder, method.getName(), method.getReturnType(), method.getDefaultValue());
  25.313 +
  25.314 +                attributes.put(method.getName(), result);
  25.315 +            }
  25.316 +
  25.317 +            return attributes.get(method.getName());
  25.318 +        }
  25.319 +
  25.320 +    }
  25.321 +
  25.322 +}

    26.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    26.2 +++ b/java.hints/spi.java.hints/src/org/netbeans/modules/java/hints/providers/code/ReflectiveCustomizerProvider.java	Wed May 08 21:47:42 2013 +0200
    26.3 @@ -0,0 +1,261 @@
    26.4 +/*
    26.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    26.6 + *
    26.7 + * Copyright 2012 Oracle and/or its affiliates. All rights reserved.
    26.8 + *
    26.9 + * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
   26.10 + * Other names may be trademarks of their respective owners.
   26.11 + *
   26.12 + * The contents of this file are subject to the terms of either the GNU
   26.13 + * General Public License Version 2 only ("GPL") or the Common
   26.14 + * Development and Distribution License("CDDL") (collectively, the
   26.15 + * "License"). You may not use this file except in compliance with the
   26.16 + * License. You can obtain a copy of the License at
   26.17 + * http://www.netbeans.org/cddl-gplv2.html
   26.18 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
   26.19 + * specific language governing permissions and limitations under the
   26.20 + * License.  When distributing the software, include this License Header
   26.21 + * Notice in each file and include the License file at
   26.22 + * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
   26.23 + * particular file as subject to the "Classpath" exception as provided
   26.24 + * by Oracle in the GPL Version 2 section of the License file that
   26.25 + * accompanied this code. If applicable, add the following below the
   26.26 + * License Header, with the fields enclosed by brackets [] replaced by
   26.27 + * your own identifying information:
   26.28 + * "Portions Copyrighted [year] [name of copyright owner]"
   26.29 + *
   26.30 + * If you wish your version of this file to be governed by only the CDDL
   26.31 + * or only the GPL Version 2, indicate your decision by adding
   26.32 + * "[Contributor] elects to include this software in this distribution
   26.33 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
   26.34 + * single choice of license, a recipient has the option to distribute
   26.35 + * your version of this file under either the CDDL, the GPL Version 2 or
   26.36 + * to extend the choice of license to its licensees as provided above.
   26.37 + * However, if you add GPL Version 2 code and therefore, elected the GPL
   26.38 + * Version 2 license, then the option applies only if the new code is
   26.39 + * made subject to such option by the copyright holder.
   26.40 + *
   26.41 + * Contributor(s):
   26.42 + *
   26.43 + * Portions Copyrighted 2012 Sun Microsystems, Inc.
   26.44 + */
   26.45 +package org.netbeans.modules.java.hints.providers.code;
   26.46 +
   26.47 +import java.awt.GridBagConstraints;
   26.48 +import java.awt.GridBagLayout;
   26.49 +import java.awt.Insets;
   26.50 +import java.awt.event.ActionEvent;
   26.51 +import java.awt.event.ActionListener;
   26.52 +import java.util.List;
   26.53 +import java.util.prefs.Preferences;
   26.54 +import javax.swing.JCheckBox;
   26.55 +import javax.swing.JComponent;
   26.56 +import javax.swing.JFormattedTextField;
   26.57 +import javax.swing.JLabel;
   26.58 +import javax.swing.JPanel;
   26.59 +import javax.swing.JSpinner;
   26.60 +import javax.swing.SpinnerNumberModel;
   26.61 +import javax.swing.event.ChangeEvent;
   26.62 +import javax.swing.event.ChangeListener;
   26.63 +import javax.swing.text.NumberFormatter;
   26.64 +import org.netbeans.spi.java.hints.BooleanOption;
   26.65 +import org.netbeans.spi.java.hints.CustomizerProvider;
   26.66 +import org.netbeans.spi.java.hints.IntegerOption;
   26.67 +import org.openide.util.Exceptions;
   26.68 +
   26.69 +/**
   26.70 + *
   26.71 + * @author lahvac
   26.72 + */
   26.73 +public class ReflectiveCustomizerProvider implements CustomizerProvider {
   26.74 +    private final String hintClassName;
   26.75 +    private final String hintId;
   26.76 +    private final List<OptionDescriptor> options;
   26.77 +
   26.78 +    public ReflectiveCustomizerProvider(String hintClassName, String hintId, List<OptionDescriptor> options) {
   26.79 +        this.hintClassName = hintClassName;
   26.80 +        this.hintId = hintId;
   26.81 +        this.options = options;
   26.82 +    }
   26.83 +
   26.84 +    @Override
   26.85 +    public JComponent getCustomizer(Preferences prefs) {
   26.86 +        return new CustomizerImpl(prefs, hintClassName, hintId, options);
   26.87 +    }
   26.88 +
   26.89 +    private static final class CustomizerImpl extends JPanel {
   26.90 +        private int row;
   26.91 +        
   26.92 +        public CustomizerImpl(Preferences prefs, String hintClassName, String hintId, List<OptionDescriptor> options) {
   26.93 +            try {
   26.94 +                setLayout(new GridBagLayout());
   26.95 +                row = 0;
   26.96 +                
   26.97 +                for (OptionDescriptor option : options) {
   26.98 +                    if (option.parameters instanceof IntegerOption) {
   26.99 +                        createIntegerOption(option, prefs);
  26.100 +                    }
  26.101 +                }
  26.102 +
  26.103 +                for (OptionDescriptor option : options) {
  26.104 +                    if (option.parameters instanceof BooleanOption) {
  26.105 +                        createBooleanOption(option, prefs);
  26.106 +                    }
  26.107 +                }
  26.108 +
  26.109 +                GridBagConstraints constraints = new GridBagConstraints();
  26.110 +
  26.111 +                constraints.anchor = GridBagConstraints.NORTHWEST;
  26.112 +                constraints.fill = GridBagConstraints.BOTH;
  26.113 +                constraints.gridheight = 1;
  26.114 +                constraints.gridwidth = GridBagConstraints.REMAINDER;
  26.115 +                constraints.gridx = 0;
  26.116 +                constraints.gridy = row++;
  26.117 +                constraints.weightx = 1;
  26.118 +                constraints.weighty = 1;
  26.119 +
  26.120 +                add(new JPanel(), constraints);
  26.121 +            } catch (IllegalArgumentException ex) {
  26.122 +                Exceptions.printStackTrace(ex);
  26.123 +            } catch (SecurityException ex) {
  26.124 +                Exceptions.printStackTrace(ex);
  26.125 +            }
  26.126 +        }
  26.127 +        
  26.128 +        private void createIntegerOption(OptionDescriptor option, Preferences prefs) {
  26.129 +            IntegerOption iopt = (IntegerOption)option.parameters;
  26.130 +            JLabel l = new JLabel();
  26.131 +            org.openide.awt.Mnemonics.setLocalizedText(l, option.displayName + ":");
  26.132 +            
  26.133 +            GridBagConstraints constraints = new GridBagConstraints();
  26.134 +            constraints.anchor = GridBagConstraints.WEST;
  26.135 +            constraints.fill = GridBagConstraints.NONE;
  26.136 +            constraints.gridheight = 1;
  26.137 +            constraints.gridwidth = 1;
  26.138 +            constraints.gridx = 0;
  26.139 +            constraints.gridy = row;
  26.140 +            constraints.weightx = 0;
  26.141 +            constraints.weighty = 0;
  26.142 +            constraints.insets = new Insets(0, 0, 0, 8);
  26.143 +            
  26.144 +            add(l, constraints);
  26.145 +            
  26.146 +            JComponent field;
  26.147 +            int val = prefs.getInt(option.preferencesKey, ((Integer)option.defaultValue).intValue());
  26.148 +            if (iopt.step() > 0) {
  26.149 +                val = Math.min(iopt.maxValue(), Math.max(iopt.minValue(), val));
  26.150 +                JSpinner spinner = new JSpinner(
  26.151 +                        new SpinnerNumberModel(val, iopt.minValue(), iopt.maxValue(), iopt.step()));
  26.152 +                spinner.addChangeListener(new ActionListenerImpl(option.preferencesKey, prefs));
  26.153 +                field = spinner;
  26.154 +            } else {
  26.155 +                NumberFormatter nf = new NumberFormatter();
  26.156 +                nf.setValueClass(Integer.class);
  26.157 +                nf.setMaximum(iopt.maxValue());
  26.158 +                nf.setMinimum(iopt.minValue());
  26.159 +                JFormattedTextField formatted = new JFormattedTextField(nf);
  26.160 +                field = formatted;
  26.161 +            }
  26.162 +            if (option.tooltip != null && !option.tooltip.isEmpty()) {
  26.163 +                field.setToolTipText(option.tooltip);
  26.164 +            }
  26.165 +            constraints = new GridBagConstraints();
  26.166 +            constraints.anchor = GridBagConstraints.WEST;
  26.167 +            constraints.fill = GridBagConstraints.HORIZONTAL;
  26.168 +            constraints.gridheight = 1;
  26.169 +            constraints.gridwidth = 1;
  26.170 +            constraints.gridx = 1;
  26.171 +            constraints.gridy = row;
  26.172 +            constraints.weightx = 0;
  26.173 +            constraints.weighty = 0;
  26.174 +            
  26.175 +            add(field, constraints);
  26.176 +
  26.177 +            constraints = new GridBagConstraints();
  26.178 +            constraints.anchor = GridBagConstraints.WEST;
  26.179 +            constraints.fill = GridBagConstraints.HORIZONTAL;
  26.180 +            constraints.gridheight = 1;
  26.181 +            constraints.gridwidth = GridBagConstraints.REMAINDER;
  26.182 +            constraints.gridx = 2;
  26.183 +            constraints.gridy = row++;
  26.184 +            constraints.weightx = 1;
  26.185 +            constraints.weighty = 0;
  26.186 +            
  26.187 +            add(new JPanel(), constraints);
  26.188 +        }
  26.189 +        
  26.190 +        private JComponent createBooleanOption(OptionDescriptor option, Preferences prefs)  {
  26.191 +            JCheckBox checkBox = new JCheckBox();
  26.192 +
  26.193 +            org.openide.awt.Mnemonics.setLocalizedText(checkBox, option.displayName);
  26.194 +            checkBox.setToolTipText(option.tooltip);
  26.195 +            checkBox.addActionListener(new ActionListenerImpl(option.preferencesKey, prefs));
  26.196 +
  26.197 +            checkBox.setSelected(prefs.getBoolean(option.preferencesKey, 
  26.198 +                    Boolean.TRUE == option.defaultValue));
  26.199 +            GridBagConstraints constraints = new GridBagConstraints();
  26.200 +
  26.201 +            constraints.anchor = GridBagConstraints.WEST;
  26.202 +            constraints.fill = GridBagConstraints.NONE;
  26.203 +            constraints.gridheight = 1;
  26.204 +            constraints.gridwidth = 2;
  26.205 +            constraints.gridx = 0;
  26.206 +            constraints.gridy = row++;
  26.207 +            constraints.weightx = 0;
  26.208 +            constraints.weighty = 0;
  26.209 +
  26.210 +            add(checkBox, constraints);
  26.211 +            return checkBox;
  26.212 +        }
  26.213 +                
  26.214 +        
  26.215 +        private static final class ActionListenerImpl implements ActionListener, ChangeListener {
  26.216 +            private final String key;
  26.217 +            private final Preferences prefs;
  26.218 +
  26.219 +            public ActionListenerImpl(String key, Preferences prefs) {
  26.220 +                this.key = key;
  26.221 +                this.prefs = prefs;
  26.222 +            }
  26.223 +
  26.224 +            @Override
  26.225 +            public void actionPerformed(ActionEvent e) {
  26.226 +                JCheckBox checkBox = ((JCheckBox)e.getSource());
  26.227 +                prefs.putBoolean(key, checkBox.isSelected());
  26.228 +            }
  26.229 +
  26.230 +            @Override
  26.231 +            public void stateChanged(ChangeEvent e) {
  26.232 +                Integer i = (Integer)((JSpinner)e.getSource()).getValue();
  26.233 +                prefs.putInt(key, i);
  26.234 +            }
  26.235 +
  26.236 +        }
  26.237 +        
  26.238 +    }
  26.239 +
  26.240 +    public static final class OptionDescriptor {
  26.241 +        public final String preferencesKey;
  26.242 +        public final Object defaultValue;
  26.243 +        public final String displayName;
  26.244 +        public final String tooltip;
  26.245 +        /**
  26.246 +         * The original Annotation object, type-specific parameters.
  26.247 +         */
  26.248 +        public final Object parameters;
  26.249 +
  26.250 +        public OptionDescriptor(
  26.251 +                String preferencesKey, 
  26.252 +                Object defaultValue, 
  26.253 +                String displayName, String tooltip, 
  26.254 +                Object parameters) {
  26.255 +            this.preferencesKey = preferencesKey;
  26.256 +            this.defaultValue = defaultValue;
  26.257 +            this.displayName = displayName;
  26.258 +            this.tooltip = tooltip;
  26.259 +            this.parameters = parameters;
  26.260 +        }
  26.261 +
  26.262 +    }
  26.263 +
  26.264 +}