Package org.apache.cxf.jaxrs.model.wadl
Class WadlGenerator
java.lang.Object
org.apache.cxf.jaxrs.model.wadl.WadlGenerator
- All Implemented Interfaces:
jakarta.ws.rs.container.ContainerRequestFilter
-
Nested Class Summary
Nested Classes -
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionbooleanaddSchemaDocument(org.apache.cxf.common.xmlschema.SchemaCollection col, List<String> tnsList, Document d, String systemId, boolean hackAroundEmptyNamespaceIssue) protected booleancompareOperations(org.apache.cxf.jaxrs.model.OperationResourceInfo ori1, org.apache.cxf.jaxrs.model.OperationResourceInfo ori2) protected ElementQNameResolvercreateElementQNameResolver(jakarta.xml.bind.JAXBContext context) protected WadlGenerator.SchemaWritercreateSchemaWriter(org.apache.cxf.jaxrs.model.ResourceTypes resourceTypes, jakarta.xml.bind.JAXBContext context, jakarta.ws.rs.core.UriInfo ui) protected voiddoFilter(jakarta.ws.rs.container.ContainerRequestContext context, org.apache.cxf.message.Message m) protected voiddoHandleClassParams(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, Map<org.apache.cxf.jaxrs.model.Parameter, Object> params, boolean isJson, org.apache.cxf.jaxrs.model.ParameterType... pType) protected voiddoHandleJaxrsBeanParamClassParams(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, Map<org.apache.cxf.jaxrs.model.Parameter, Object> params, boolean isJson, org.apache.cxf.jaxrs.model.ParameterType... pType) protected voiddoWriteParam(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, org.apache.cxf.jaxrs.model.Parameter pm, Class<?> type, Type genericType, String paramName, Annotation[] anns, boolean isJson) protected voidendMethodRequestTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) protected voidendMethodResponseTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) protected voidendMethodTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) protected voidendResourceTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) voidfilter(jakarta.ws.rs.container.ContainerRequestContext context) generateWADL(String baseURI, List<org.apache.cxf.jaxrs.model.ClassResourceInfo> cris, boolean isJson, org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui) protected StringgetBaseURI(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui) jakarta.ws.rs.core.ResponsegetExistingResource(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui, String href) jakarta.ws.rs.core.ResponsegetExistingWadl(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui, jakarta.ws.rs.core.MediaType mt) protected StringList<org.apache.cxf.jaxrs.model.ClassResourceInfo>getResourcesList(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui) protected voidhandleClassJavaDocs(org.apache.cxf.jaxrs.model.ClassResourceInfo cri, StringBuilder sb) protected booleanhandleDocs(Annotation[] anns, StringBuilder sb, String category, boolean allowDefault, boolean isJson) protected voidhandleDynamicSubresource(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, org.apache.cxf.jaxrs.model.ClassResourceInfo subcri, boolean isJson) protected voidhandleGrammars(StringBuilder sbApp, StringBuilder sbGrammars, WadlGenerator.SchemaWriter writer, Map<Class<?>, QName> clsMap) protected booleanhandleOperation(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, Map<org.apache.cxf.jaxrs.model.Parameter, Object> classParams, org.apache.cxf.jaxrs.model.OperationResourceInfo nextOp, boolean resourceTagOpened, boolean isJson, int index) protected voidhandleOperJavaDocs(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb) protected voidhandleOperParamJavaDocs(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, int paramIndex, StringBuilder sb) protected voidhandleOperResponseJavaDocs(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb) protected voidhandleParameter(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, org.apache.cxf.jaxrs.model.Parameter pm, boolean isJson) protected voidhandleParams(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, org.apache.cxf.jaxrs.model.ParameterType type, boolean isJson) protected voidhandlePathAndMatrixClassParams(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, Map<org.apache.cxf.jaxrs.model.Parameter, Object> params, boolean isJson) protected voidhandlePathAndMatrixParams(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, boolean isJson) protected voidhandleRepresentation(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, Class<?> type, boolean isJson, boolean inbound) protected voidhandleResource(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.ClassResourceInfo cri, Set<org.apache.cxf.jaxrs.model.ClassResourceInfo> visitedResources, boolean isJson) voidsetAddResourceAndMethodIds(boolean addResourceAndMethodIds) voidsetAllowList(List<String> allowList) voidsetApplicationTitle(String applicationTitle) voidsetApplyStylesheetLocally(boolean applyStylesheetLocally) voidsetCheckAbsolutePathSlash(boolean checkAbsolutePathSlash) voidsetConvertResourcesToDOM(boolean convertResourcesToDOM) voidSet the default WADL response media type.voidSet the default representation media type to be used if JAX-RS Produces or Consumes annotation is missing.voidsetDocumentationProvider(List<org.apache.cxf.jaxrs.model.doc.DocumentationProvider> ps) voidsetDocumentationProvider(org.apache.cxf.jaxrs.model.doc.DocumentationProvider p) voidsetExternalLinks(List<String> externalLinks) voidsetExtraClasses(List<Class<?>> extraClasses) The list of classes which should be added to the generated scheme also.voidsetIgnoreForwardSlash(boolean ignoreForwardSlash) voidsetIgnoreMessageWriters(boolean ignoreMessageWriters) voidsetIgnoreOverloadedMethods(boolean ignore) voidsetIgnoreRequests(boolean ignoreRequests) voidsetIncludeDefaultWadlSchemaLocation(boolean inc) voidsetIncrementNamespacePrefix(boolean incrementNamespacePrefix) voidsetJavaDocPath(String path) voidsetJavaDocPaths(String... paths) voidsetJavaDocURLs(URL[] javaDocURLs) voidsetJaxbContextProperties(Map<String, Object> jaxbContextProperties) voidsetKeepRelativeDocLinks(boolean keepRelativeDocLinks) voidsetLinkAnyMediaTypeToXmlSchema(boolean link) voidsetLinkJsonToXmlSchema(boolean link) Deprecated.voidsetNamespacePrefix(String prefix) voidsetPrivateAddresses(List<String> privateAddresses) voidsetResolver(ElementQNameResolver resolver) voidvoidsetSchemaLocations(List<String> locations) voidsetSingleResourceMultipleMethods(boolean singleResourceMultipleMethods) voidsetStylesheetReference(String stylesheetReference) voidsetSupportCollections(boolean support) voidsetSupportJaxbSubstitutions(boolean supportJaxbSubstitutions) voidsetSupportJaxbXmlType(boolean supportJaxbXmlType) voidsetUseJaxbContextForQnames(boolean checkJaxbOnly) voidsetUsePathParamsToCompareOperations(boolean usePathParamsToCompareOperations) voidsetUseSingleSlashResource(boolean useSingleSlashResource) voidsetWadlNamespace(String namespace) voidprotected List<org.apache.cxf.jaxrs.model.OperationResourceInfo>sortOperationsByPath(Set<org.apache.cxf.jaxrs.model.OperationResourceInfo> ops) protected voidstartMethodRequestTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) protected voidstartMethodResponseTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) protected voidstartMethodTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) protected voidstartResourceTag(StringBuilder sb, org.apache.cxf.jaxrs.model.ClassResourceInfo cri, String path) protected voidstartResourceTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, String path)
-
Field Details
-
WADL_QUERY
- See Also:
-
WADL_TYPE
public static final jakarta.ws.rs.core.MediaType WADL_TYPE -
WADL_NS
- See Also:
-
DEFAULT_WADL_SCHEMA_LOC
- See Also:
-
-
Constructor Details
-
WadlGenerator
public WadlGenerator() -
WadlGenerator
public WadlGenerator(org.apache.cxf.Bus bus)
-
-
Method Details
-
setExtraClasses
The list of classes which should be added to the generated scheme also. -
filter
public void filter(jakarta.ws.rs.container.ContainerRequestContext context) - Specified by:
filterin interfacejakarta.ws.rs.container.ContainerRequestFilter
-
doFilter
protected void doFilter(jakarta.ws.rs.container.ContainerRequestContext context, org.apache.cxf.message.Message m) -
generateWADL
public StringBuilder generateWADL(String baseURI, List<org.apache.cxf.jaxrs.model.ClassResourceInfo> cris, boolean isJson, org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui) -
getBaseURI
-
handleGrammars
protected void handleGrammars(StringBuilder sbApp, StringBuilder sbGrammars, WadlGenerator.SchemaWriter writer, Map<Class<?>, QName> clsMap) -
handleResource
protected void handleResource(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.ClassResourceInfo cri, Set<org.apache.cxf.jaxrs.model.ClassResourceInfo> visitedResources, boolean isJson) -
startResourceTag
protected void startResourceTag(StringBuilder sb, org.apache.cxf.jaxrs.model.ClassResourceInfo cri, String path) -
getPath
-
startMethodTag
protected void startMethodTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) -
endMethodTag
-
startMethodRequestTag
protected void startMethodRequestTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) -
startMethodResponseTag
protected void startMethodResponseTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) -
endMethodRequestTag
protected void endMethodRequestTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) -
endMethodResponseTag
protected void endMethodResponseTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) -
startResourceTag
protected void startResourceTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, String path) -
endResourceTag
protected void endResourceTag(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori) -
handleOperation
protected boolean handleOperation(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, Map<org.apache.cxf.jaxrs.model.Parameter, Object> classParams, org.apache.cxf.jaxrs.model.OperationResourceInfo nextOp, boolean resourceTagOpened, boolean isJson, int index) -
compareOperations
protected boolean compareOperations(org.apache.cxf.jaxrs.model.OperationResourceInfo ori1, org.apache.cxf.jaxrs.model.OperationResourceInfo ori2) -
handleDynamicSubresource
protected void handleDynamicSubresource(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, org.apache.cxf.jaxrs.model.ClassResourceInfo subcri, boolean isJson) -
handlePathAndMatrixClassParams
protected void handlePathAndMatrixClassParams(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, Map<org.apache.cxf.jaxrs.model.Parameter, Object> params, boolean isJson) -
doHandleClassParams
protected void doHandleClassParams(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, Map<org.apache.cxf.jaxrs.model.Parameter, Object> params, boolean isJson, org.apache.cxf.jaxrs.model.ParameterType... pType) -
doHandleJaxrsBeanParamClassParams
protected void doHandleJaxrsBeanParamClassParams(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, Map<org.apache.cxf.jaxrs.model.Parameter, Object> params, boolean isJson, org.apache.cxf.jaxrs.model.ParameterType... pType) -
handlePathAndMatrixParams
protected void handlePathAndMatrixParams(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, boolean isJson) -
handleParameter
protected void handleParameter(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, org.apache.cxf.jaxrs.model.Parameter pm, boolean isJson) -
handleParams
protected void handleParams(StringBuilder sb, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, org.apache.cxf.jaxrs.model.ParameterType type, boolean isJson) -
doWriteParam
protected void doWriteParam(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb, org.apache.cxf.jaxrs.model.Parameter pm, Class<?> type, Type genericType, String paramName, Annotation[] anns, boolean isJson) -
handleRepresentation
protected void handleRepresentation(StringBuilder sb, Set<Class<?>> jaxbTypes, ElementQNameResolver qnameResolver, Map<Class<?>, QName> clsMap, org.apache.cxf.jaxrs.model.OperationResourceInfo ori, Class<?> type, boolean isJson, boolean inbound) -
sortOperationsByPath
-
getResourcesList
public List<org.apache.cxf.jaxrs.model.ClassResourceInfo> getResourcesList(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui) -
getExistingWadl
public jakarta.ws.rs.core.Response getExistingWadl(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui, jakarta.ws.rs.core.MediaType mt) -
getExistingResource
public jakarta.ws.rs.core.Response getExistingResource(org.apache.cxf.message.Message m, jakarta.ws.rs.core.UriInfo ui, String href) -
addSchemaDocument
-
setIgnoreMessageWriters
public void setIgnoreMessageWriters(boolean ignoreMessageWriters) -
handleClassJavaDocs
protected void handleClassJavaDocs(org.apache.cxf.jaxrs.model.ClassResourceInfo cri, StringBuilder sb) -
handleOperJavaDocs
protected void handleOperJavaDocs(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb) -
handleOperResponseJavaDocs
protected void handleOperResponseJavaDocs(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, StringBuilder sb) -
handleOperParamJavaDocs
protected void handleOperParamJavaDocs(org.apache.cxf.jaxrs.model.OperationResourceInfo ori, int paramIndex, StringBuilder sb) -
handleDocs
protected boolean handleDocs(Annotation[] anns, StringBuilder sb, String category, boolean allowDefault, boolean isJson) -
setWadlNamespace
-
setSingleResourceMultipleMethods
public void setSingleResourceMultipleMethods(boolean singleResourceMultipleMethods) -
setUseSingleSlashResource
public void setUseSingleSlashResource(boolean useSingleSlashResource) -
setLinkJsonToXmlSchema
Deprecated. -
setLinkAnyMediaTypeToXmlSchema
public void setLinkAnyMediaTypeToXmlSchema(boolean link) -
setSchemaLocations
-
setUseJaxbContextForQnames
public void setUseJaxbContextForQnames(boolean checkJaxbOnly) -
createElementQNameResolver
-
createSchemaWriter
protected WadlGenerator.SchemaWriter createSchemaWriter(org.apache.cxf.jaxrs.model.ResourceTypes resourceTypes, jakarta.xml.bind.JAXBContext context, jakarta.ws.rs.core.UriInfo ui) -
setExternalLinks
-
setResolver
-
setPrivateAddresses
-
getPrivateAddresses
-
setAddResourceAndMethodIds
public void setAddResourceAndMethodIds(boolean addResourceAndMethodIds) -
setResourceIdGenerator
-
setApplicationTitle
-
setNamespacePrefix
-
setIgnoreForwardSlash
public void setIgnoreForwardSlash(boolean ignoreForwardSlash) -
setIgnoreRequests
public void setIgnoreRequests(boolean ignoreRequests) -
setSupportCollections
public void setSupportCollections(boolean support) -
setDefaultMediaType
Set the default WADL response media type. For example, a browser may display WADL better if Content-Type is set to application/xml which is a default response content type. Users may set it to application/vnd.sun.wadl+xml or other type.- Parameters:
mt- WADL response media type
-
setDefaultRepresentationMediaType
Set the default representation media type to be used if JAX-RS Produces or Consumes annotation is missing. Wild-card media type is used by default in such cases.- Parameters:
mt- the default representation media type
-
setSupportJaxbXmlType
public void setSupportJaxbXmlType(boolean supportJaxbXmlType) -
setSupportJaxbSubstitutions
public void setSupportJaxbSubstitutions(boolean supportJaxbSubstitutions) -
setCheckAbsolutePathSlash
public void setCheckAbsolutePathSlash(boolean checkAbsolutePathSlash) -
setJavaDocPath
- Throws:
Exception
-
setJavaDocPaths
- Throws:
Exception
-
setJavaDocURLs
-
setDocumentationProvider
public void setDocumentationProvider(org.apache.cxf.jaxrs.model.doc.DocumentationProvider p) -
setDocumentationProvider
-
setStylesheetReference
-
setWadlSchemaLocation
-
setIncludeDefaultWadlSchemaLocation
public void setIncludeDefaultWadlSchemaLocation(boolean inc) -
setIgnoreOverloadedMethods
public void setIgnoreOverloadedMethods(boolean ignore) -
setKeepRelativeDocLinks
public void setKeepRelativeDocLinks(boolean keepRelativeDocLinks) -
setApplyStylesheetLocally
public void setApplyStylesheetLocally(boolean applyStylesheetLocally) -
setUsePathParamsToCompareOperations
public void setUsePathParamsToCompareOperations(boolean usePathParamsToCompareOperations) -
setConvertResourcesToDOM
public void setConvertResourcesToDOM(boolean convertResourcesToDOM) -
setIncrementNamespacePrefix
public void setIncrementNamespacePrefix(boolean incrementNamespacePrefix) -
setJaxbContextProperties
-
getAllowList
-
setAllowList
-