net.java.dev.webdav.jaxrs.xml

Class WebDavContextResolver

java.lang.Object

net.java.dev.webdav.jaxrs.xml.WebDavContextResolver

All Implemented Interfaces:

javax.ws.rs.ext.ContextResolver<JAXBContext>

@Provider
public final class WebDavContextResolver
extends Object
implements javax.ws.rs.ext.ContextResolver<JAXBContext>

Provides support for custom extensions to WebDAV, like custom Properties and XML Elements.
WebDAV allows custom extensions for XML Elements and Properties. To enable JAX-RS to deal with these, each of them must be implemented as a JAXB class and registered by passing it to the constructor of this resolver.

Author:

Markus KARG (mkarg@java.net)

See Also:

Chapter 17 "XML Extensibility in DAV" of RFC 2616 "Hypertext Transfer Protocol -- HTTP/1.1"

Constructor Summary

Constructors

Constructor and Description
WebDavContextResolver(Class<?>... additionalClasses) Creates an instance of this resolver, registering the provided custom XML Elements and Properties.

Method Summary

Methods

Modifier and Type	Method and Description
JAXBContext	getContext(Class<?> cls)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WebDavContextResolver

public WebDavContextResolver(Class<?>... additionalClasses)
                      throws JAXBException

Creates an instance of this resolver, registering the provided custom XML Elements and Properties.

Parameters:

additionalClasses - The custom extensions (JAXB classes) to be registered (can be left blank).

Throws:

JAXBException - if an error was encountered while creating the JAXBContext, such as (but not limited to): No JAXB implementation was discovered, Classes use JAXB annotations incorrectly, Classes have colliding annotations (i.e., two classes with the same type name), The JAXB implementation was unable to locate provider-specific out-of-band information (such as additional files generated at the development time.)

Method Detail

getContext

public final JAXBContext getContext(Class<?> cls)

Specified by:

getContext in interface javax.ws.rs.ext.ContextResolver<JAXBContext>

Returns:

A single, shared context for both, WebDAV XML Elements and Properties and custom extensions.