com.sun.jersey.server.wadl

Interface WadlGenerator

All Known Implementing Classes:

WadlGeneratorApplicationDoc, WadlGeneratorGrammarsSupport, WadlGeneratorImpl, WadlGeneratorResourceDocSupport

public interface WadlGenerator

A WadlGenerator creates artifacts related to wadl. This is designed as an interface, so that several implementations can decorate existing ones. One decorator could e.g. add references to definitions within some xsd for existing representations.
Created on: Jun 16, 2008

Version:

$Id$

Author:

Martin Grotzke

Method Summary

Methods

Modifier and Type	Method and Description
Application	createApplication()
Method	createMethod(AbstractResource r, AbstractResourceMethod m)
Param	createParam(AbstractResource r, AbstractMethod m, Parameter p)
Request	createRequest(AbstractResource r, AbstractResourceMethod m)
RepresentationType	createRequestRepresentation(AbstractResource r, AbstractResourceMethod m, MediaType mediaType)
Resource	createResource(AbstractResource r, java.lang.String path)
Resources	createResources()
Response	createResponse(AbstractResource r, AbstractResourceMethod m)
java.lang.String	getRequiredJaxbContextPath() The jaxb context path that is used when the generated wadl application is marshalled to a file. This method is used in a decorator like manner. The result return the path (or a colon-separated list of package names) containing jaxb-beans that are added to wadl elements by this WadlGenerator, additionally to the context path of the decorated WadlGenerator (set by setWadlGeneratorDelegate(WadlGenerator). If you do not use custom jaxb beans, then simply return _delegate.getRequiredJaxbContextPath(), otherwise return the delegate's getRequiredJaxbContextPath() together with your required context path (separated by a colon):
void	init() Invoked before all methods related to wadl-building are invoked.
void	setWadlGeneratorDelegate(WadlGenerator delegate) Sets the delegate that is decorated by this wadl generator.

Method Detail

setWadlGeneratorDelegate

void setWadlGeneratorDelegate(WadlGenerator delegate)

Sets the delegate that is decorated by this wadl generator. Is invoked directly after this generator is instantiated before init() or any setter method is invoked.

Parameters:

delegate - the wadl generator to decorate

init

void init()
          throws java.lang.Exception

Invoked before all methods related to wadl-building are invoked. This method is used in a decorator like manner, and therefore has to invoke this.delegate.init().

Throws:

java.lang.Exception

getRequiredJaxbContextPath

java.lang.String getRequiredJaxbContextPath()

The jaxb context path that is used when the generated wadl application is marshalled to a file.
This method is used in a decorator like manner.
The result return the path (or a colon-separated list of package names) containing jaxb-beans that are added to wadl elements by this WadlGenerator, additionally to the context path of the decorated WadlGenerator (set by setWadlGeneratorDelegate(WadlGenerator).
If you do not use custom jaxb beans, then simply return _delegate.getRequiredJaxbContextPath(), otherwise return the delegate's getRequiredJaxbContextPath() together with your required context path (separated by a colon):

_delegate.getRequiredJaxbContextPath() == null
            ? ${yourContextPath}
            : _delegate.getRequiredJaxbContextPath() + ":" + ${yourContextPath};

If you add the path for your custom jaxb beans, don't forget to add an ObjectFactory (annotated with XmlRegistry) to this package.

Returns:

simply the getRequiredJaxbContextPath() of the delegate or the getRequiredJaxbContextPath() + ":" + ${yourContextPath}.

createApplication

Application createApplication()

createResources

Resources createResources()

createResource

Resource createResource(AbstractResource r,
                      java.lang.String path)

createMethod

Method createMethod(AbstractResource r,
                  AbstractResourceMethod m)

createRequest

Request createRequest(AbstractResource r,
                    AbstractResourceMethod m)

createRequestRepresentation

RepresentationType createRequestRepresentation(AbstractResource r,
                                             AbstractResourceMethod m,
                                             MediaType mediaType)

createResponse

Response createResponse(AbstractResource r,
                      AbstractResourceMethod m)

createParam

Param createParam(AbstractResource r,
                AbstractMethod m,
                Parameter p)