使用 Decorator 进行 JBoss RESTeasy JAX-RS JAXB 模式验证

Question

我正在尝试验证在 JBoss AS 7 内运行的应用程序中通过我的（合同优先）REST 接口传入的所有传入 XML 文件。我已经编写了一个用于漂亮打印的 @Decorator （如 JBoss RESTeasy 文档中的示例）并且类似的，用于为解组器打开 XML 模式验证。不幸的是，解组器的装饰器从未被调用。

这是 Pretty Decorator 的代码：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import javax.xml.bind.Marshaller;

import org.jboss.resteasy.annotations.Decorator;

@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Decorator(processor = PrettyProcessor.class, target = Marshaller.class)
public @interface Pretty {}

---

和实现：

import java.lang.annotation.Annotation;

import javax.ws.rs.core.MediaType;
import javax.xml.bind.Marshaller;
import javax.xml.bind.PropertyException;

import org.apache.log4j.Logger;
import org.jboss.resteasy.annotations.DecorateTypes;
import org.jboss.resteasy.spi.interception.DecoratorProcessor;

@DecorateTypes({ "text/*+xml", "application/*+xml", MediaType.APPLICATION_XML, MediaType.TEXT_XML })
public class PrettyProcessor implements DecoratorProcessor<Marshaller, Pretty> {
    private static final Logger LOGGER = Logger.getLogger(PrettyProcessor.class);

    @Override
    public Marshaller decorate(Marshaller target, Pretty annotation, Class type, Annotation[] annotations, MediaType mediaType) {
        LOGGER.debug("Pretty.");
        try {
            target.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
        } catch (PropertyException e) {
        }
        return target;
    }
}

---

现在是 Validate 的注释（不起作用）：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import javax.xml.bind.Unmarshaller;

import org.jboss.resteasy.annotations.Decorator;

@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Decorator(processor = ValidateProcessor.class, target = Unmarshaller.class)
public @interface Validate {}

---

实现：

import java.lang.annotation.Annotation;

import javax.ws.rs.core.MediaType;
import javax.ws.rs.ext.Provider;
import javax.xml.XMLConstants;
import javax.xml.bind.Marshaller;
import javax.xml.bind.PropertyException;
import javax.xml.bind.Unmarshaller;
import javax.xml.transform.Source;
import javax.xml.transform.stream.StreamSource;
import javax.xml.validation.Schema;
import javax.xml.validation.SchemaFactory;

import org.apache.log4j.Logger;
import org.jboss.resteasy.annotations.DecorateTypes;
import org.jboss.resteasy.spi.interception.DecoratorProcessor;
import org.xml.sax.SAXException;

@DecorateTypes({ "text/*+xml", "application/*+xml", MediaType.APPLICATION_XML, MediaType.TEXT_XML })
public class ValidateProcessor implements DecoratorProcessor<Unmarshaller, Validate> {
    private static final Logger LOGGER = Logger.getLogger(ValidateProcessor.class);

    @Override
    public Unmarshaller decorate(Unmarshaller target, Validate annotation,  Class type, Annotation[] annotations, MediaType mediaType) {
        target.setSchema(getSchema());
        LOGGER.debug("Set validation schema.");
        System.out.println("Set validation schema.");
        return target;
    }
}

---

和 REST 接口的代码：

import javax.annotation.security.RolesAllowed;
import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.SecurityContext;
import javax.xml.ws.WebServiceException;

@Path("/{mdvt}/{ouid}/order")
public interface OrderResource {

    @RolesAllowed({ "mpa" })
    @POST
    @Path("/update")
    @Consumes({MediaType.APPLICATION_XML, MediaType.TEXT_XML})
    @Produces(MediaType.APPLICATION_XML)
    @Pretty
    public Response update(@Context SecurityContext sec,
            @PathParam("ouid") String ouID, 
            @PathParam("mdvt") long masterDataVersionTag,
            @Validate UpdateOrdersRequest uor) throws WebServiceException;
}

---

在同一个 REST 方法上，（更新） @Pretty Decorator被调用，而 @Validate 则不会。我在这里做错了什么？

我发现了一个旧错误 Decorator for Jaxb unmarshaller does not work 已关闭。

那里的评论说一切正常，上面的代码几乎与那里的代码完全相同，包括解决方案。然而，Unmarshaller 没有任何作用。

Answer 1

最后，这个问题在 JBoss AS 7 中得到了解决。

问题出在 Resteasy 实现上，直到版本 2.3.5.Final 为止，该实现都存在错误。

请参阅 https://issues.jboss.org/browse/RESTEASY-711 但忽略提到的解决方法，直到版本 2.3.5 才起作用。

可行的解决方案是下载 Restwasy 发行版 2.3.5.Final 或更高版本，解压并查找resteasy-jboss-modules-2.3.5.Final.zip

将此文件解压到 JBoss AS 7.1.1 和 Resteasy 的根目录中将更新至新版本。完成这一步后，以上所有代码就可以正常工作了。

感谢比尔·伯克（Bill Burke）为我指出了解决方案，

Answer 2

您可以实现一个 MessageBodyReader，它在 JAXB Unmarshaller 上设置 Schema 来执行验证。有关示例代码，请查看我对类似问题的回答：

• 验证 JPA/JAX-RS Web 服务中的 JAXBElement