FormattingSourceCode

This is version 14. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

This tutorial is divided in two. First we have to setup an ant task that calls jalopy to format your code, once there we'll have to modify appfuse's source code (I hope it's not for long, since all we do is modify the javadoc comments in the code).

Setup AppFuse

• First you need to create a folder named lib/jalopy-1.0b11 and extract the contents of jalopy-1.0b11.zip in there.
• Edit the lib/lib.properties file and add this lines at the end

#
# Jalopy - http://jalopy.sourceforge.net
#
jalopy.version=1.0b11
jalopy.dir=${lib.dir}/jalopy-${jalopy.version}
jalopy.jar=${jalopy.dir}/jalopy-ant-0.6.2.jar

• Open the properties.xml and search for the <path id="web.test.classpath">...</path> section and add the following under it

<path id="jalopy.classpath">
    <path refid="dao.test.classpath"/>
    <path refid="service.test.classpath"/>
    <path refid="web.test.classpath"/>
    <fileset dir="${jalopy.dir}" includes="*.jar"/>
</path>

• Open the build.xml file and search for the <!-- Taskdefs --> section and add the following under it

        <taskdef name="jalopy"
            classname="de.hunsicker.jalopy.plugin.ant.AntPlugin"
            classpath="${jalopy.jar}"/>

• Still in the same file (build.xml) find the docs target and add the following above it

    <target name="jalopy" depends="compile">
        <jalopy convention="um.xml"
            loglevel="info"
            threads="2"
            classpathref="jalopy.classpath">
            <fileset dir="${src}">
                <include name="**/*.java"/>
            </fileset>
        </jalopy>
    </target>

Thats it!!! Well... not quite, we still have to modify some javadocs :-)...

Fixing AppFuse's javadocs

Before this it all was fun, now comes the ugly part... But be patient, it's worth it!!!

• Open /src/dao/org/appfuse/dao/hibernate.BaseDaoHibernate.java file and add a <p> at the start of the class javadoc.
• Open /src/dao/org/appfuse/model/LabelValue.java file and insert * <p> before the line 14 and change both <p/> in lines 11 and 12 respectively for <br/>.
• Open /src/dao/org/appfuse/model/Address.java file and add a <p> at the start of the class javadoc.
• Open /src/dao/org/appfuse/model/Role.java file and add a <p> at the start of the class javadoc and in the @author section Dan Kibler [email protected] should be <a href="mailto:[email protected]">Dan Kibler</a>.
• Open /src/dao/org/appfuse/model/User.java file and do the same with the @author.
• Open /src/service/org/appfuse/service/impl/RoleManagerImpl.java file and add a <p> at the start of the class javadoc.
• Open /src/service/org/appfuse/service/impl/UserManagerImpl.java file and add a <p> at the start of the class javadoc.
• Open /src/service/org/appfuse/util/StringUtil.java file and remove the carriage return in line 14 (it should look like this: * <a href="StringUtil.java.html"><i>View Source</i></a>).

jalopy-1.0b11.zip		1343353 bytes
um.xml		14555 bytes