Chapter 1 - Netbeans配置和运行Jetty源代码

在Netbeans里面新建一个Java project, 然后把Jetty 6的源码加进来，添加一些必要的依赖包，添加ant脚本，开启调试。

1. 新建一个Java project, 加入Jetty 6 source package

   你可以从这个url拿到源码包:
   http://dist.codehaus.org/jetty/jetty-6.1.26/jetty-6.1.26-src.zip

2. 添加编译jetty时必须的依赖包：

   servlet-api-2.5-20081211.jar
   slf4j-api-1.3.1.jar


3. 添加配置文件：

   etc/jetty.xml
   etc/webdefault.xml
   realm.properties

4. 配置Netbeans脚本:
  

<project xmlns="http://www.netbeans.org/ns/project/1">
    <type>org.netbeans.modules.ant.freeform</type>
    <configuration>
        <!-- Either of the below two is applicable -->
        <!--<general-data xmlns="http://www.netbeans.org/ns/freeform-project/1">-->
        <general-data xmlns="http://www.netbeans.org/ns/freeform-project/2">
            <name>jetty</name>
            <properties>
                <property name="ant.script">nbproject/targets.xml</property>
                <property name="jetty.script">build/jetty-build.xml</property>
            </properties>
            <folders>
                <source-folder>
                    <label>jetty</label>
                    <location>.</location>
                    <encoding>windows-1252</encoding>
                </source-folder>
                <source-folder>
                    <label>Java Sources</label>
                    <type>java</type>
                    <location>src</location>
                    <encoding>windows-1252</encoding>
                </source-folder>
            </folders>
            <ide-actions>
                <action name="build">
                    <script>${jetty.script}</script>
                    <target>nbbuild</target>
                </action>
                <action name="clean">
                    <script>${jetty.script}</script>
                    <target>clean</target>
                </action>
                <action name="run">
                    <script>${jetty.script}</script>
                    <target>nbrun</target>
                </action>
                <action name="debug">
                    <script>${jetty.script}</script>
                    <target>nbdebug</target>
                </action>
            </ide-actions>
            <view>
                <items>
                    <source-folder style="tree">
                        <label>Web folder</label>
                        <location>webapps</location>
                    </source-folder>
                    <source-folder style="tree">
                        <label>Jetty configs</label>
                        <location>webapps/WEB-INF/etc</location>
                    </source-folder>
                    <source-folder style="packages">
                        <label>Java src</label>
                        <location>src</location>
                    </source-folder>
                </items>
                <context-menu>
                    <ide-action name="build"/>
                    <ide-action name="clean"/>
                    <ide-action name="javadoc"/>
                    <ide-action name="run"/>
                    <ide-action name="test"/>
                    <ide-action name="debug"/>
                </context-menu>
            </view>
        </general-data>
        <java-data xmlns="http://www.netbeans.org/ns/freeform-project-java/3">
            <compilation-unit>
                <package-root>src</package-root>
                <classpath mode="compile"></classpath>
                <built-to>classes</built-to>
                <javadoc-built-to>doc</javadoc-built-to>
                <source-level>1.6</source-level>
            </compilation-unit>
        </java-data>
    </configuration>
</project>

5. 添加jetty脚本

   每次compile时候，会根据更改情况，生成新的classes。这些classes会被jar(update)到jetty-6.1.26.jar。启动IDE的debugger，然后启动jetty6,并把jetty6附加到debugger上，这样可以调试代码的运行

   a. build脚本
   javac.source=1.6
   javac.target=1.6
   JAVAC_EXE=
   srcDir=source directory
   outDir=output directory
  

    <target name="nbbuild" depends="configProperties">
        <javac source="${javac.source}" target="${javac.target}"
            executable="${JAVAC_EXE}" fork="yes" destdir="${outDir}"
            classpath="${outDir}" classpathref="libraries"
            optimize="off" verbose="off" debug="on"
            memoryInitialSize="512M" memoryMaximumSize="768M">
            <src path="${srcDir}"/>
            <include name="**/*.java"/>
        </javac>
        
        <jar update="true" compress="true" jarfile="${jettyOutDir}\\lib\\jetty-6.1.26.jar">
            <manifest>
                <attribute name="Build-Date" value="${build.time}"/>
                <attribute name="Build-User" value="${user.name}"/>
                <attribute name="Build-File" value="${ant.file}"/>
                <attribute name="Build-Location" value="${prefix}"/>
                <attribute name="Build-Platform" value="${os.name} ${os.version}(${os.arch})"/>
                <attribute name="Specification-Title" value="${java.specification.name}"/>
                <attribute name="Specification-Vendor" value="${java.vendor}"/>
                <attribute name="Specification-Version" value="${java.version}"/>
                <attribute name="CopyrightNotice" value="Copyright (c) 2012-${build.year} ${corp.name}"/>
                <attribute name="Implementation-Title" value="${ant.project.name} - HTTPS Handler"/>
                <attribute name="Implementation-Vendor" value="${corp.name}"/>
                <attribute name="Implementation-Version" value="${build.version}"/>
            </manifest>
            <fileset dir="${outDir}">
                <include name="org/mortbay/**/*.class"/>
            </fileset>
        </jar>
    </target>
   

   b. debug脚本
  

    <target name="nbdebug" depends="nbbuild">
        <!-- Copy the necessary configuration files and libraries to the jetty output direction -->
        <copy todir="${jettyOutDir}" file="jetty/start.jar" overwrite="no"/>
        <copy todir="${jettyOutDir}/etc" overwrite="no">
            <fileset dir="jetty/etc">
                <include name="jetty.xml"/>
                <include name="webdefault.xml"/>
                <include name="configure.dtd"/>
                <include name="realm.properties"/>
            </fileset>
        </copy>

        <copy todir="${jettyOutDir}/lib" overwrite="no">
            <fileset dir="lib">
                <include name="**/*.jar"/>
            </fileset>
        </copy>
        <copy todir="${jettyOutDir}/ext" overwrite="no">
            <fileset dir="jetty/ext">
                <include name="*.jar"/>
            </fileset>
        </copy>
        <mkdir dir="${jettyOutDir}/lib"/>
        <mkdir dir="${jettyOutDir}/bin/logs"/>
        <copy todir="${jettyOutDir}/webapps" overwrite="no">
            <fileset dir="webapps">
                <include name="**/*"/>
            </fileset>
        </copy>

        <!-- Start the debugger -->
        <nbjpdastart name="Jetty 6" addressproperty="jpda.address2" transport="dt_socket">
            <sourcepath>
                <pathelement path="${srcDir}"/>
            </sourcepath>
        </nbjpdastart>
        
        <!-- Start the application -->
        <java jar="${jettyOutDir}\\start.jar" fork="yes" dir="${jettyOutDir}\\bin" failonerror="true"
            classpathref="libraries" jvm="${java.executable}">
            <jvmarg value="-Xdebug"/>
            <jvmarg value="-mx256M"/>
            <jvmarg value="-Xnoagent"/>
            <jvmarg value="-Djetty.home=."/>
            <jvmarg value="-Djava.compiler=none"/>
            <jvmarg value="-Xrunjdwp:transport=dt_socket,address=${jpda.address2}"/>
            <jvmarg value="-DSTOP.PORT=-1"/>
            <jvmarg value="-Xverify:none"/>
            <jvmarg value="-Xbootclasspath/a:${jettyOutDir}\\ext\\mail.jar"/>
            <jvmarg value="-Dprimary.address=10.158.171.103"/>
            <jvmarg value="-Dprimary.port=8080"/>
        </java>
    </target>
   

6. 调试源代码

点击debug，可以看到output panel上有输出，debug toolbar也会出现。在jetty代码里加个断点，就可以调试了。