Я документирую некоторые веб-службы Java и поддерживающие их типы данных. Есть две службы, которые я не хочу документировать. Каков правильный способ исключить небольшое количество файлов из задачи Ant javadoc?
Я пробовал несколько итераций, используя файлы или наборы файлов, вложенные в исходный путь или исходные файлы с различными комбинациями включения и исключения.
Базовая цель, которую я определил правильно, документирует все мои веб-службы:
<target name="javadoc.webservices" description="Generate the documentation for companyproject webservices">
<delete dir="docs/webservices" failonerror="true"/>
<mkdir dir="docs/webservices"/>
<javadoc packagenames="com.company.project.webservices,com.company.project.models.*"
defaultexcludes="yes"
destdir="docs/webservices"
author="true"
version="true"
use="true"
windowtitle="company project Webservices">
<doctitle><![CDATA[<h1>company project Webservices</h1>]]></doctitle>
<bottom><![CDATA[<i>Copyright © 2011 company Corp. All Rights Reserved.</i>]]></bottom>
<sourcepath>
<path location="companyproject-ejb/src/java"/>
<path location="companyproject-models/src"/>
</sourcepath>
<classpath>
<path refid="companyproject-models.module.classpath"/>
<path refid="companyproject-ejb.module.classpath"/>
<pathelement location="${companyproject-ejb.output.dir}"/>
</classpath>
</javadoc>
</target>
Некоторые варианты, которые я пробовал, включают:
<sourcefiles>
<fileset dir="companyproject-ejb/src/java">
<include name="**/*.java"/>
<exclude name="**/*IntegrationTestWS*, **/*NhinInterfaceWS*"/>
</fileset>
</sourcefiles>
Эта ошибка с javadoc.exe Ошибка CreateProcess = 87, параметр неверен
<sourcepath>
<fileset dir="companyproject-ejb/src/java">
<include name="**/*.java"/>
<exclude name="**/*IntegrationTestWS*, **/*NhinInterfaceWS*"/>
</fileset>
</sourcepath>
Та же ошибка, что и исходные файлы, но есть много сообщений о том, что пропускается
.
Я пробовал аналогичные варианты, используя
вместо ] <набор файлов>
.
Думаю, мне не хватает базового понимания того, как работает включает / исключает. Спасибо за вашу помощь!
AlexR не совсем понял, но подошел близко. Я удалил
и добавил
<fileset dir="./Companyproject-ejb/src/java/">
<include name="com/Company/project/webservices/*"/>
<exclude name="**/IntegrationTestWS*"/>
<exclude name="**/NhinInterfaceWS*"/>
</fileset>
<packageset dir="./Companyproject-models/src/">
<include name="com/Company/project/models/**"/>
</packageset>
Из-за наличия только набора файлов javadoc жаловался, что не может найти никаких пакетов. Packageset ведет себя как dirset, поэтому он не может исключать отдельные файлы, только каталоги. В этом случае я смог определить набор пакетов для одного набора документов и набор файлов для ограниченного набора и обойти это.