使用Enunciate生成Java客户端库

时间:2012-03-02 08:27:18

标签: rest documentation enunciate

我想要使用Maven使用Enunciate 1.25来记录几个RESTful Web服务。如果我在没有自定义enunciate.xml的情况下构建,则所有客户端库都按预期构建。

...
<build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.enunciate</groupId>
                <artifactId>maven-enunciate-plugin</artifactId>
                <version>${maven-enunciate-plugin.version}</version>
                <!-- configuration>
                    <configFile>src/main/resources/enunciate.xml</configFile>
                </configuration -->
                <executions>
                    <execution>
                        <goals>
                            <goal>assemble</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
...

一旦我添加了我的自定义enunciate.xml,就不会生成java的客户端库

<?xml version="1.0"?>
<enunciate label="service/myservice" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://enunciate.codehaus.org/schemas/enunciate-1.25.xsd">

    <modules>
        <docs splashPackage="myservice.service"
            includeDefaultDownloads="false" disableRestMountpoint="true"
            applyWsdlFilter="false" docsDir="api" title="My Service API"
            copyright="ME Inc" />
        <basic-app disabled="false" />
        <java-client disabled="false" />
        <xml disabled="false" />
        <jaxws-client disabled="false" />
        <jboss disabled="false" />
        <jaxws-ri disabled="true" />
        <jaxws-support disabled="true" />
        <csharp disabled="true" />
        <jersey disabled="true" />
        <c disabled="true" />
        <obj-c disabled="true" />
    </modules>

    <webapp disabled="false" mergeWebXML="../webapp/WEB-INF/web.xml" />

    <namespaces>
        <namespace uri="http://schema.me/services/myservice" id="myservice" />
    </namespaces>

    <services>
        <rest defaultRestSubcontext="/" />
    </services>

    <api-classes>
        <include pattern="myservice.service.*" />
    </api-classes>

</enunciate>

我做错了什么或错过了什么?

1 个答案:

答案 0 :(得分:3)

includeDefaultDownloads =“false”应为true