Unable to avoid generating oasis.names.tc.xacml._3_0.core.schema.wd_17.ObjectFactory

[gogolander]

My application needs to deserialize the <AttributeProviders> DTO resulting from the GET /pap/attribute.providers. After registering an attribute provider of mine, though, the deserialization fails with the error

Caused by: org.glassfish.jaxb.runtime.v2.runtime.IllegalAnnotationsException: 2 counts of IllegalAnnotationExceptions
Non è presente alcun ObjectFactory con un @XmlElementDecl per l'elemento {urn:oasis:names:tc:xacml:3.0:core:schema:wd-17}PolicyIdReference.
	this problem is related to the following location:
		at private final java.util.List oasis.names.tc.xacml._3_0.core.schema.wd_17.PolicyIdentifierList.policyIdReferencesAndPolicySetIdReferences
		at oasis.names.tc.xacml._3_0.core.schema.wd_17.PolicyIdentifierList
		at private final oasis.names.tc.xacml._3_0.core.schema.wd_17.PolicyIdentifierList oasis.names.tc.xacml._3_0.core.schema.wd_17.Result.policyIdentifierList
		at oasis.names.tc.xacml._3_0.core.schema.wd_17.Result
		at private final java.util.List oasis.names.tc.xacml._3_0.core.schema.wd_17.Response.results
		at oasis.names.tc.xacml._3_0.core.schema.wd_17.Response
Non è presente alcun ObjectFactory con un @XmlElementDecl per l'elemento {urn:oasis:names:tc:xacml:3.0:core:schema:wd-17}PolicySetIdReference.
	this problem is related to the following location:
		at private final java.util.List oasis.names.tc.xacml._3_0.core.schema.wd_17.PolicySet.policySetsAndPoliciesAndPolicySetIdReferences
		at oasis.names.tc.xacml._3_0.core.schema.wd_17.PolicySet

The attribute provider has been developed following the guide: https://authzforce-ce-fiware.readthedocs.io/en/latest/UserAndProgrammersGuide.html#making-an-attribute-provider.

After some digging it looks like jaxb:generate builds another oasis.names.tc.xacml._3_0.core.schema.wd_17.ObjectFactory that, depending on the order of the dependencies in my pom.xml, superseeds the correct located in the org.ow2.authzforce:authzforce-ce-xacml-model.
I've tried a number of approches, from setting the episodes to manually removing the unwanted ObjectFactory but I'm unable to find what I think is the proper solution: set the jaxb-maven-plugin in such a way to avoid generating that file.
Am I missing something?

I'm posting the binding.xjb and the relevant portion of the pom.xml:

• binding.xjb

<?xml version="1.0" encoding="UTF-8"?>
<!-- JAXB version must be 3.0 for jaxb-maven-plugin 4.x -->
<jaxb:bindings jaxb:version="3.0" xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb" xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
	jaxb:extensionBindingPrefixes="xjc">
	<jaxb:globalBindings generateMixedExtensions="true" fixedAttributeAsConstantProperty="true">
		<xjc:simple />
	</jaxb:globalBindings>
</jaxb:bindings>

• pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
[...]

    <properties>
        <compiler-plugin.version>3.14.0</compiler-plugin.version>
        <maven.compiler.release>17</maven.compiler.release>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <skipITs>true</skipITs>
        <surefire-plugin.version>3.5.4</surefire-plugin.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.ow2.authzforce</groupId>
            <artifactId>authzforce-ce-core-pdp-api</artifactId>
            <version>22.0.0</version>
            <scope>provided</scope>
        </dependency>
[...]
    <build>
        <plugins>
[...]
            <plugin>
                <groupId>org.jvnet.jaxb</groupId>
                <artifactId>jaxb-maven-plugin</artifactId>
                <version>4.0.0</version>
                <configuration>
                    <!-- debug=true will generate JAXBDebug class. More info: https://github.com/highsource/maven-jaxb2-plugin/wiki/Miscellaneous -->
                    <debug>false</debug>
                    <strict>false</strict>
                    <verbose>true</verbose>
                    <removeOldOutput>true</removeOldOutput>
                    <extension>true</extension>
                    <useDependenciesAsEpisodes>true</useDependenciesAsEpisodes>
                    <catalog>src/main/jaxb/catalog.xml</catalog>
                    <bindingDirectory>src/main/jaxb</bindingDirectory>
                    <schemaDirectory>src/main/resources</schemaDirectory>
                    <!-- If you wish to use extensions, for exemple Value Constructor -->
                    <!--
                    <args>
                         <arg>-Xvalue-constructor</arg>
                      </args>
                      <plugins>
                         <plugin>
                               <groupId>org.jvnet.jaxb</groupId>
                               <artifactId>jaxb-plugins</artifactId>
                               <version>4.0.0</version>
                         </plugin>
                      </plugins>
                      -->
                </configuration>
                <executions>
                    <execution>
                        <id>jaxb-generate-compile-sources</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

[cdanger]

Seems like a JAXB issue. I assume you may have had a look at the JAXB Tools documentation, but I'm mentioning it just in case.
Could you share a minimal version of your Maven project? or at least your XML schema(s) in src/main/resources, and the catalog src/main/jaxb/catalog.xml so that I can try to reproduce somehow?

Also instead of <useDependenciesAsEpisodes>true</useDependenciesAsEpisodes>, you can try to configure the episodes explicitly like in https://github.com/authzforce/core/blob/develop/pdp-testutils/pom.xml for instance:

...
<useDependenciesAsEpisodes>false</useDependenciesAsEpisodes>
<episodes>
    <episode>
        <groupId>org.ow2.authzforce</groupId>
        <artifactId>authzforce-ce-xmlns-model</artifactId>
    </episode>
    <episode>
        <groupId>org.ow2.authzforce</groupId>
        <artifactId>authzforce-ce-xacml-model</artifactId>
    </episode>
    <episode>
        <groupId>org.ow2.authzforce</groupId>
        <artifactId>authzforce-ce-pdp-ext-model</artifactId>
    </episode>
</episodes>
...

[gogolander]

I assume you may have had a look at the JAXB Tools documentation, but I'm mentioning it just in case.

Yes, I checked that jaxb is supposed to exclude these classes from creating the ObjectFactory for the objects in the wd-17 namespace.

Could you share a minimal version of your Maven project? or at least your XML schema(s) in src/main/resources, and the catalog src/main/jaxb/catalog.xml so that I can try to reproduce somehow?

I'm sorry: I thought I attached the catalog.xml already. I tried to set the episodes expicitly, exactly in the way You suggested, but I got the same result. I attached the pom.xml with the <useDependenciesAsEpisodes>true</useDependenciesAsEpisodes> as per documentation. Could the version with the explicit episodes help You? In such a case I'll give that version too.

pom.xml

catalog.xml

EDIT: I'm attaching the binding.xjb too, in case it's of any help:

<?xml version="1.0" encoding="UTF-8"?>
<!-- JAXB version must be 3.0 for jaxb-maven-plugin 4.x -->
<jaxb:bindings jaxb:version="3.0" xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb" xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
	jaxb:extensionBindingPrefixes="xjc">
	<jaxb:globalBindings generateMixedExtensions="true" fixedAttributeAsConstantProperty="true">
		<xjc:simple />
	</jaxb:globalBindings>
</jaxb:bindings>

[cdanger]

Thanks. Could you attach the XSD too?

[gogolander]

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           targetNamespace="http://example.it/authz/xmlns/attributeproviders/test"
           xmlns="http://example.it/authz/xmlns/attributeproviders/test"
           xmlns:authz-ext="http://authzforce.github.io/xmlns/pdp/ext/3"
           xmlns:xacml="urn:oasis:names:tc:xacml:3.0:core:schema:wd-17" elementFormDefault="qualified" version="3.5.9">
    <xs:import namespace="urn:oasis:names:tc:xacml:3.0:core:schema:wd-17" />
    <xs:import namespace="http://authzforce.github.io/xmlns/pdp/ext/3" />
    <xs:import namespace="http://www.w3.org/XML/1998/namespace"
               schemaLocation="http://www.w3.org/2001/xml.xsd"/>
    <xs:annotation>
        <xs:documentation xml:lang="en">
            Attribute Provider di test: dichiara gli attribute che può risolvere e da quali dipende
        </xs:documentation>
    </xs:annotation>
    <xs:complexType name="AttributeDesignatorsType">
        <xs:annotation>
            <xs:documentation>
                List of AttributeDesignatorTypes
            </xs:documentation>
        </xs:annotation>
        <xs:sequence>
            <xs:element ref="xacml:AttributeDesignator" minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
        <xs:attribute ref="xml:id" use="optional"/>
    </xs:complexType>
    <xs:element name="DependencyAttributes" type="AttributeDesignatorsType"/>
    <xs:element name="AttributeDesignators" type="AttributeDesignatorsType"/>
    <xs:complexType name="MyAttributeProviderDescriptor">
        <xs:annotation>
            <xs:documentation>
                Test Attribute Provider configuration descriptor. This Provider is used for test purposes only. It can be
                configured to support any attribute but returns always an empty bag as attribute value.
            </xs:documentation>
        </xs:annotation>
        <xs:complexContent>
            <xs:extension base="authz-ext:AbstractAttributeProvider">
                <xs:sequence>
                    <xs:element ref="DependencyAttributes" minOccurs="1" maxOccurs="1" />
                    <xs:element ref="AttributeDesignators" maxOccurs="1" minOccurs="1" />
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
</xs:schema>

As You could see, I'm trying to expose a list of xacml:AttributeDesignator to make it easy to set my attributeprovider dependecies but that throws that strange behaviour.

[cdanger]

It seems the issue is with the underlying XJC when it handles the XSD element ref="xacml:AttributeDesignator" in your schema. My guess is that it is (wrongly in my opinion) trying to find a specific binding for this element in the episodes (and it is nowhere because the authzforce-ce-xacml-model JAR has bindings only for the complexTypes), therefore it re-generates an oasis.names.tc.xacml._3_0.core.schema.wd_17.ObjectFactory with a createAttributeDesignator(...) method. (It also generates a createExpression(...) method for some reason unknown to me, although ExpressionType is abstract, so it shouldn't. Another mysterious thing from XJC :-( ).

So the first workaround that works for me is to replace this in your schema:

            <xs:element ref="xacml:AttributeDesignator" minOccurs="0" maxOccurs="unbounded" />

with this:

   <xs:element name="AttributeDesignator" type="xacml:AttributeDesignatorType" minOccurs="0" maxOccurs="unbounded" />

In this case, XJC finds xacml:AttributeDesignatorType in the episode and does not regenerate oasis.names.tc.xacml._3_0.core.schema.wd_17.ObjectFactory.

A second workaround is the one suggested here by highsource: highsource/jaxb-tools#60
i.e. delete the ObjectFactory is a post-process script (before it gets included in the JAR). For example with maven-antrun-plugin, you can add this to your POM at the end of the <plugins> element:

...
            <plugin>
                <artifactId>maven-antrun-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>process-sources</phase>
                        <configuration>
                            <target>
                                <delete verbose="true" dir="${basedir}/target/generated-sources/xjc/oasis" />
                            </target>
                        </configuration>
                        <goals>
                            <goal>run</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

        </plugins>
    </build>
...

[gogolander]

I'm glad that You managed to replicate the issue, meaning: I'm not the only one having that problem :)
I've been using the second workaround to avoid being stopped by this bug. I tried Your first solution because it looks way cleaner to me but it still builds the wd-17.ObjectFactory. I'm using this configuration for the build jaxb-maven-plugin:

              <plugin>
                <groupId>org.jvnet.jaxb</groupId>
                <artifactId>jaxb-maven-plugin</artifactId>
                <version>4.0.0</version>
                <configuration>
                    <!-- debug=true will generate JAXBDebug class. More info: https://github.com/highsource/maven-jaxb2-plugin/wiki/Miscellaneous -->
                    <debug>false</debug>
                    <strict>false</strict>
                    <verbose>true</verbose>
                    <removeOldOutput>true</removeOldOutput>
                    <extension>true</extension>
                    <catalog>src/main/jaxb/catalog.xml</catalog>
                    <bindingDirectory>src/main/jaxb</bindingDirectory>
                    <schemaDirectory>src/main/resources</schemaDirectory>
                    <useDependenciesAsEpisodes>false</useDependenciesAsEpisodes>
                    <episodes>
                        <episode>
                            <groupId>org.ow2.authzforce</groupId>
                            <artifactId>authzforce-ce-xmlns-model</artifactId>
                        </episode>
                        <episode>
                            <groupId>org.ow2.authzforce</groupId>
                            <artifactId>authzforce-ce-xacml-model</artifactId>
                        </episode>
                        <episode>
                            <groupId>org.ow2.authzforce</groupId>
                            <artifactId>authzforce-ce-pdp-ext-model</artifactId>
                        </episode>
                    </episodes>
                    <!-- If you wish to use extensions, for exemple Value Constructor -->
                    <!--
                    <args>
                         <arg>-Xvalue-constructor</arg>
                      </args>
                      <plugins>
                         <plugin>
                               <groupId>org.jvnet.jaxb</groupId>
                               <artifactId>jaxb-plugins</artifactId>
                               <version>4.0.0</version>
                         </plugin>
                      </plugins>
                      -->
                </configuration>
                <executions>
                    <execution>
                        <id>jaxb-generate-compile-sources</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

[cdanger]

I put up the Maven project for testing the first workaround here:
https://github.com/cdanger/authzforce-core-issue-96-fix

When I do mvn clean generate-sources, I don't get any ObjectFactory.java in the generated-sources/xjc/oasis/.... Make sure you are using the same plugin versions or later. Also I'm using useDependenciesAsEpisodes=true this time.