What does "<property name="jboss.api" value="private"/>" in module.xml mean ?

[zhouyaguo]

Hi,all:

     i found the following content in jboss-as-7.1.3.Final/modules/org/jboss/resteasy/resteasy-atom-provider/main/module.xml

<module xmlns="urn:jboss:module:1.1" name="org.jboss.resteasy.resteasy-atom-provider">

    <properties>

        <property name="jboss.api" value="private"/>

    </properties>

    <resources>

        <resource-root path="resteasy-atom-provider-2.3.3.Final.jar"/>

    <resource-root path="resteasy-atom-provider-2.3.3.Final-jandex.jar"/>

        <!-- Insert resources here -->

    </resources>

    <dependencies>

        <module name="com.sun.xml.bind"/>

        <module name="javax.xml.bind.api"/>

        <module name="javax.api"/>

        <module name="javax.enterprise.api"/>

        <module name="javax.servlet.api"/>

        <module name="javax.ws.rs.api"/>

        <module name="org.jboss.resteasy.resteasy-jaxrs"/>

        <module name="org.jboss.resteasy.resteasy-jaxb-provider"/>

    </dependencies>

</module>

what does "<property name="jboss.api" value="private"/>" mean? i see also the "value" can be "unsupported" somewhere. who will read the property "jboss.api"?

Regards

Yaguo Zhou

[nickarls]

I think it's just a marker that triggers a warning that you are using an unstable API that can be removed or changed at any point...

[jeff.zhang]

FYI:

http://jboss-as7-development.1055759.n5.nabble.com/Javadoc-private-modules-vs-non-private-deps-what-to-include-again-td5710719.html

http://jboss-as7-development.1055759.n5.nabble.com/what-is-jboss-api-private-exactly-td5711072.html

[zhouyaguo]

Thanks Nicklas and Jeff. U guys helped me a lot!