|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.sun.jersey.server.wadl.generators.AbstractWadlGeneratorGrammarGenerator<T>
public abstract class AbstractWadlGeneratorGrammarGenerator<T>
This WadlGenerator generates a grammar based on the referenced
elements. This is a template class designed to be overridden by specific
implementations, for example XML Schema and JSON Schema
| Nested Class Summary | |
|---|---|
protected static interface |
AbstractWadlGeneratorGrammarGenerator.HasType
|
protected class |
AbstractWadlGeneratorGrammarGenerator.Pair
|
protected static interface |
AbstractWadlGeneratorGrammarGenerator.WantsName<T>
|
| Nested classes/interfaces inherited from interface com.sun.jersey.server.wadl.WadlGenerator |
|---|
WadlGenerator.Environment, WadlGenerator.ExternalGrammarDefinition, WadlGenerator.Resolver |
| Field Summary | |
|---|---|
protected FeaturesAndProperties |
_fap
|
protected java.util.List<AbstractWadlGeneratorGrammarGenerator.Pair> |
_hasTypeWantsName
|
protected Providers |
_providers
|
protected java.lang.Class<T> |
_resolvedType
|
protected java.net.URI |
_root
|
protected java.util.Set<java.lang.Class> |
_seeAlso
|
protected java.net.URI |
_wadl
|
static java.util.Set<java.lang.Class> |
SPECIAL_GENERIC_TYPES
|
| Constructor Summary | |
|---|---|
protected |
AbstractWadlGeneratorGrammarGenerator(WadlGenerator delegate,
java.lang.Class<T> resolvedType)
|
| Method Summary | |
|---|---|
abstract boolean |
acceptMediaType(MediaType type)
|
void |
attachTypes(ApplicationDescription introspector)
Process the elements in the WADL definition to attach schema types as required. |
protected abstract WadlGenerator.Resolver |
buildModelAndSchemas(java.util.Map<java.lang.String,ApplicationDescription.ExternalGrammar> extraFiles)
Build the the external schema files and generate a suitable resolver |
com.sun.research.ws.wadl.Application |
createApplication(UriInfo requestInfo)
|
WadlGenerator.ExternalGrammarDefinition |
createExternalGrammar()
Perform any post create functions such as generating grammars. |
com.sun.research.ws.wadl.Method |
createMethod(AbstractResource ar,
AbstractResourceMethod arm)
|
com.sun.research.ws.wadl.Param |
createParam(AbstractResource ar,
AbstractMethod am,
Parameter p)
|
protected abstract AbstractWadlGeneratorGrammarGenerator.WantsName<T> |
createParmWantsName(com.sun.research.ws.wadl.Param param)
|
protected abstract AbstractWadlGeneratorGrammarGenerator.WantsName<T> |
createRepresentationWantsName(com.sun.research.ws.wadl.Representation rt)
|
com.sun.research.ws.wadl.Request |
createRequest(AbstractResource ar,
AbstractResourceMethod arm)
|
com.sun.research.ws.wadl.Representation |
createRequestRepresentation(AbstractResource ar,
AbstractResourceMethod arm,
MediaType mt)
|
com.sun.research.ws.wadl.Resource |
createResource(AbstractResource ar,
java.lang.String path)
|
com.sun.research.ws.wadl.Resources |
createResources()
|
java.util.List<com.sun.research.ws.wadl.Response> |
createResponses(AbstractResource ar,
AbstractResourceMethod arm)
|
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 WadlGenerator.setWadlGeneratorDelegate(WadlGenerator).If you do not use custom jaxb beans, then simply return _delegate.getRequiredJaxbContextPath(),
otherwise return the delegate's WadlGenerator.getRequiredJaxbContextPath() together with
your required context path (separated by a colon): |
void |
init()
Invoked before all methods related to wadl-building are invoked. |
protected static AbstractWadlGeneratorGrammarGenerator.HasType |
parameter(Parameter param,
MediaType mt)
|
void |
setEnvironment(WadlGenerator.Environment env)
Provides the WadlGenerator with the current generating environment. |
void |
setWadlGeneratorDelegate(WadlGenerator delegate)
Sets the delegate that is decorated by this wadl generator. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
public static final java.util.Set<java.lang.Class> SPECIAL_GENERIC_TYPES
protected java.util.Set<java.lang.Class> _seeAlso
protected java.util.List<AbstractWadlGeneratorGrammarGenerator.Pair> _hasTypeWantsName
protected java.net.URI _root
protected java.net.URI _wadl
protected Providers _providers
protected FeaturesAndProperties _fap
protected java.lang.Class<T> _resolvedType
| Constructor Detail |
|---|
protected AbstractWadlGeneratorGrammarGenerator(WadlGenerator delegate,
java.lang.Class<T> resolvedType)
| Method Detail |
|---|
protected static AbstractWadlGeneratorGrammarGenerator.HasType parameter(Parameter param,
MediaType mt)
param - parameter.
public void setWadlGeneratorDelegate(WadlGenerator delegate)
WadlGeneratorWadlGenerator.init() or any setter method is invoked.
setWadlGeneratorDelegate in interface WadlGeneratordelegate - the wadl generator to decoratepublic java.lang.String getRequiredJaxbContextPath()
WadlGeneratorWadlGenerator.setWadlGeneratorDelegate(WadlGenerator)._delegate.getRequiredJaxbContextPath(),
otherwise return the delegate's WadlGenerator.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.
getRequiredJaxbContextPath in interface WadlGeneratorWadlGenerator.getRequiredJaxbContextPath() of the delegate or the
WadlGenerator.getRequiredJaxbContextPath() + ":" + ${yourContextPath}.
public void init()
throws java.lang.Exception
WadlGeneratorthis.delegate.init().
init in interface WadlGeneratorjava.lang.Exceptionpublic void setEnvironment(WadlGenerator.Environment env)
this.delegate.setEnvironment(env).
setEnvironment in interface WadlGeneratorpublic abstract boolean acceptMediaType(MediaType type)
type -
public com.sun.research.ws.wadl.Application createApplication(UriInfo requestInfo)
createApplication in interface WadlGeneratorcom.sun.jersey.server.wadl.WadlGenerator#createApplication()
public com.sun.research.ws.wadl.Method createMethod(AbstractResource ar,
AbstractResourceMethod arm)
createMethod in interface WadlGeneratorar - abstract resourcearm - abstract resource method
WadlGenerator.createMethod(com.sun.jersey.api.model.AbstractResource, com.sun.jersey.api.model.AbstractResourceMethod)
public com.sun.research.ws.wadl.Request createRequest(AbstractResource ar,
AbstractResourceMethod arm)
createRequest in interface WadlGeneratorar - abstract resourcearm - abstract resource method
WadlGenerator.createRequest(com.sun.jersey.api.model.AbstractResource, com.sun.jersey.api.model.AbstractResourceMethod)
public com.sun.research.ws.wadl.Param createParam(AbstractResource ar,
AbstractMethod am,
Parameter p)
createParam in interface WadlGeneratorar - abstract resourceam - abstract methodp - parameter
WadlGenerator.createParam(com.sun.jersey.api.model.AbstractResource, com.sun.jersey.api.model.AbstractMethod, com.sun.jersey.api.model.Parameter)
public com.sun.research.ws.wadl.Representation createRequestRepresentation(AbstractResource ar,
AbstractResourceMethod arm,
MediaType mt)
createRequestRepresentation in interface WadlGeneratorar - abstract resourcearm - abstract resource methodmt - media type
WadlGenerator.createRequestRepresentation(com.sun.jersey.api.model.AbstractResource, com.sun.jersey.api.model.AbstractResourceMethod, javax.ws.rs.core.MediaType)
public com.sun.research.ws.wadl.Resource createResource(AbstractResource ar,
java.lang.String path)
createResource in interface WadlGeneratorar - abstract resourcepath - resources path
WadlGenerator.createResource(com.sun.jersey.api.model.AbstractResource, java.lang.String)public com.sun.research.ws.wadl.Resources createResources()
createResources in interface WadlGeneratorWadlGenerator.createResources()
public java.util.List<com.sun.research.ws.wadl.Response> createResponses(AbstractResource ar,
AbstractResourceMethod arm)
createResponses in interface WadlGeneratorar - abstract resourcearm - abstract resource method
WadlGenerator.createResponses(com.sun.jersey.api.model.AbstractResource, com.sun.jersey.api.model.AbstractResourceMethod)public WadlGenerator.ExternalGrammarDefinition createExternalGrammar()
WadlGenerator
createExternalGrammar in interface WadlGeneratorprotected abstract WadlGenerator.Resolver buildModelAndSchemas(java.util.Map<java.lang.String,ApplicationDescription.ExternalGrammar> extraFiles)
extraFiles - public void attachTypes(ApplicationDescription introspector)
WadlGenerator
attachTypes in interface WadlGeneratorintrospector - The root description used to resolve these entriesprotected abstract AbstractWadlGeneratorGrammarGenerator.WantsName<T> createParmWantsName(com.sun.research.ws.wadl.Param param)
protected abstract AbstractWadlGeneratorGrammarGenerator.WantsName<T> createRepresentationWantsName(com.sun.research.ws.wadl.Representation rt)
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||