Fix broken Javadoc related to `<` and `>`
This commit is contained in:
parent
71e2d8e9de
commit
2defb6555e
|
|
@ -25,7 +25,7 @@ import org.springframework.util.Assert;
|
|||
/**
|
||||
* {@link org.springframework.beans.factory.parsing.ComponentDefinition}
|
||||
* that bridges the gap between the advisor bean definition configured
|
||||
* by the {@code <aop:advisor>} tag and the component definition
|
||||
* by the {@code <aop:advisor>} tag and the component definition
|
||||
* infrastructure.
|
||||
*
|
||||
* @author Rob Harrop
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
|
|||
* {@code NamespaceHandler} for the {@code aop} namespace.
|
||||
*
|
||||
* <p>Provides a {@link org.springframework.beans.factory.xml.BeanDefinitionParser} for the
|
||||
* {@code <aop:config>} tag. A {@code config} tag can include nested
|
||||
* {@code <aop:config>} tag. A {@code config} tag can include nested
|
||||
* {@code pointcut}, {@code advisor} and {@code aspect} tags.
|
||||
*
|
||||
* <p>The {@code pointcut} tag allows for creation of named
|
||||
|
|
|
|||
|
|
@ -49,7 +49,7 @@ import org.springframework.util.StringUtils;
|
|||
import org.springframework.util.xml.DomUtils;
|
||||
|
||||
/**
|
||||
* {@link BeanDefinitionParser} for the {@code <aop:config>} tag.
|
||||
* {@link BeanDefinitionParser} for the {@code <aop:config>} tag.
|
||||
*
|
||||
* @author Rob Harrop
|
||||
* @author Juergen Hoeller
|
||||
|
|
@ -123,7 +123,7 @@ class ConfigBeanDefinitionParser implements BeanDefinitionParser {
|
|||
|
||||
/**
|
||||
* Configures the auto proxy creator needed to support the {@link BeanDefinition BeanDefinitions}
|
||||
* created by the '{@code <aop:config/>}' tag. Will force class proxying if the
|
||||
* created by the '{@code <aop:config/>}' tag. Will force class proxying if the
|
||||
* '{@code proxy-target-class}' attribute is set to '{@code true}'.
|
||||
* @see AopNamespaceUtils
|
||||
*/
|
||||
|
|
@ -132,7 +132,7 @@ class ConfigBeanDefinitionParser implements BeanDefinitionParser {
|
|||
}
|
||||
|
||||
/**
|
||||
* Parses the supplied {@code <advisor>} element and registers the resulting
|
||||
* Parses the supplied {@code <advisor>} element and registers the resulting
|
||||
* {@link org.springframework.aop.Advisor} and any resulting {@link org.springframework.aop.Pointcut}
|
||||
* with the supplied {@link BeanDefinitionRegistry}.
|
||||
*/
|
||||
|
|
@ -428,7 +428,7 @@ class ConfigBeanDefinitionParser implements BeanDefinitionParser {
|
|||
}
|
||||
|
||||
/**
|
||||
* Parses the supplied {@code <pointcut>} and registers the resulting
|
||||
* Parses the supplied {@code <pointcut>} and registers the resulting
|
||||
* Pointcut with the BeanDefinitionRegistry.
|
||||
*/
|
||||
private AbstractBeanDefinition parsePointcut(Element pointcutElement, ParserContext parserContext) {
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@ import org.springframework.beans.factory.xml.ParserContext;
|
|||
|
||||
/**
|
||||
* {@link BeanDefinitionDecorator} responsible for parsing the
|
||||
* {@code <aop:scoped-proxy/>} tag.
|
||||
* {@code <aop:scoped-proxy/>} tag.
|
||||
*
|
||||
* @author Rob Harrop
|
||||
* @author Juergen Hoeller
|
||||
|
|
|
|||
|
|
@ -826,7 +826,7 @@ public abstract class AbstractBeanDefinition extends BeanMetadataAttributeAccess
|
|||
/**
|
||||
* Set whether this bean definition is 'synthetic', that is, not defined
|
||||
* by the application itself (for example, an infrastructure bean such
|
||||
* as a helper for auto-proxying, created through {@code <aop:config>}).
|
||||
* as a helper for auto-proxying, created through {@code <aop:config>}).
|
||||
*/
|
||||
public void setSynthetic(boolean synthetic) {
|
||||
this.synthetic = synthetic;
|
||||
|
|
|
|||
|
|
@ -90,7 +90,7 @@ import org.springframework.util.StringUtils;
|
|||
* <pre class="code"><util:properties location="jdbc.properties"/></pre>
|
||||
*
|
||||
* <p>The observant reader will notice that the sole attribute on the
|
||||
* {@code <util:properties/>} element matches the
|
||||
* {@code <util:properties/>} element matches the
|
||||
* {@link org.springframework.beans.factory.config.PropertiesFactoryBean#setLocation(org.springframework.core.io.Resource)}
|
||||
* method name on the {@code PropertiesFactoryBean} (the general
|
||||
* usage thus illustrated holds true for any number of attributes).
|
||||
|
|
|
|||
|
|
@ -22,15 +22,15 @@ import org.springframework.beans.factory.config.BeanDefinitionHolder;
|
|||
|
||||
/**
|
||||
* Interface used by the {@link DefaultBeanDefinitionDocumentReader}
|
||||
* to handle custom, nested (directly under a {@code <bean>}) tags.
|
||||
* to handle custom, nested (directly under a {@code <bean>}) tags.
|
||||
*
|
||||
* <p>Decoration may also occur based on custom attributes applied to the
|
||||
* {@code <bean>} tag. Implementations are free to turn the metadata in the
|
||||
* {@code <bean>} tag. Implementations are free to turn the metadata in the
|
||||
* custom tag into as many
|
||||
* {@link org.springframework.beans.factory.config.BeanDefinition BeanDefinitions} as
|
||||
* required and to transform the
|
||||
* {@link org.springframework.beans.factory.config.BeanDefinition} of the enclosing
|
||||
* {@code <bean>} tag, potentially even returning a completely different
|
||||
* {@code <bean>} tag, potentially even returning a completely different
|
||||
* {@link org.springframework.beans.factory.config.BeanDefinition} to replace the
|
||||
* original.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -398,7 +398,7 @@ public class BeanDefinitionParserDelegate {
|
|||
|
||||
/**
|
||||
* Return the default settings for bean definitions as indicated within
|
||||
* the attributes of the top-level {@code <beans/>} element.
|
||||
* the attributes of the top-level {@code <beans/>} element.
|
||||
*/
|
||||
public BeanDefinitionDefaults getBeanDefinitionDefaults() {
|
||||
BeanDefinitionDefaults bdd = new BeanDefinitionDefaults();
|
||||
|
|
@ -412,7 +412,7 @@ public class BeanDefinitionParserDelegate {
|
|||
|
||||
/**
|
||||
* Return any patterns provided in the 'default-autowire-candidates'
|
||||
* attribute of the top-level {@code <beans/>} element.
|
||||
* attribute of the top-level {@code <beans/>} element.
|
||||
*/
|
||||
public String[] getAutowireCandidatePatterns() {
|
||||
String candidatePattern = this.defaults.getAutowireCandidates();
|
||||
|
|
@ -421,7 +421,7 @@ public class BeanDefinitionParserDelegate {
|
|||
|
||||
|
||||
/**
|
||||
* Parses the supplied {@code <bean>} element. May return {@code null}
|
||||
* Parses the supplied {@code <bean>} element. May return {@code null}
|
||||
* if there were errors during parse. Errors are reported to the
|
||||
* {@link org.springframework.beans.factory.parsing.ProblemReporter}.
|
||||
*/
|
||||
|
|
@ -430,7 +430,7 @@ public class BeanDefinitionParserDelegate {
|
|||
}
|
||||
|
||||
/**
|
||||
* Parses the supplied {@code <bean>} element. May return {@code null}
|
||||
* Parses the supplied {@code <bean>} element. May return {@code null}
|
||||
* if there were errors during parse. Errors are reported to the
|
||||
* {@link org.springframework.beans.factory.parsing.ProblemReporter}.
|
||||
*/
|
||||
|
|
@ -1011,7 +1011,7 @@ public class BeanDefinitionParserDelegate {
|
|||
* constructor-arg element.
|
||||
* @param ele subelement of property element; we don't know which yet
|
||||
* @param defaultValueType the default type (class name) for any
|
||||
* {@code <value>} tag that might be created
|
||||
* {@code <value>} tag that might be created
|
||||
*/
|
||||
public Object parsePropertySubElement(Element ele, BeanDefinition bd, String defaultValueType) {
|
||||
if (!isDefaultNamespace(ele)) {
|
||||
|
|
|
|||
|
|
@ -19,7 +19,7 @@ package org.springframework.beans.factory.xml;
|
|||
import org.springframework.beans.factory.parsing.DefaultsDefinition;
|
||||
|
||||
/**
|
||||
* Simple JavaBean that holds the defaults specified at the {@code <beans>}
|
||||
* Simple JavaBean that holds the defaults specified at the {@code <beans>}
|
||||
* level in a standard Spring XML bean definition document:
|
||||
* {@code default-lazy-init}, {@code default-autowire}, etc.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -32,8 +32,8 @@ import org.springframework.beans.factory.config.BeanDefinitionHolder;
|
|||
* custom nested tags.
|
||||
*
|
||||
* <p>The parser will call {@link #parse} when it encounters a custom tag
|
||||
* directly under the {@code <beans>} tags and {@link #decorate} when
|
||||
* it encounters a custom tag directly under a {@code <bean>} tag.
|
||||
* directly under the {@code <beans>} tags and {@link #decorate} when
|
||||
* it encounters a custom tag directly under a {@code <bean>} tag.
|
||||
*
|
||||
* <p>Developers writing their own custom element extensions typically will
|
||||
* not implement this interface directly, but rather make use of the provided
|
||||
|
|
@ -61,7 +61,7 @@ public interface NamespaceHandler {
|
|||
* that is embedded in the supplied {@link ParserContext}.
|
||||
* <p>Implementations should return the primary {@code BeanDefinition}
|
||||
* that results from the parse phase if they wish to be used nested
|
||||
* inside (for example) a {@code <property>} tag.
|
||||
* inside (for example) a {@code <property>} tag.
|
||||
* <p>Implementations may return {@code null} if they will
|
||||
* <strong>not</strong> be used in a nested scenario.
|
||||
* @param element the element that is to be parsed into one or more {@code BeanDefinitions}
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ import org.springframework.instrument.classloading.websphere.WebSphereLoadTimeWe
|
|||
*
|
||||
* <p>Typically registered for the default bean name
|
||||
* "{@code loadTimeWeaver}"; the most convenient way to achieve this is
|
||||
* Spring's {@code <context:load-time-weaver>} XML tag.
|
||||
* Spring's {@code <context:load-time-weaver>} XML tag.
|
||||
*
|
||||
* <p>This class implements a runtime environment check for obtaining the
|
||||
* appropriate weaver implementation: As of Spring 4.0, it detects Oracle WebLogic 10,
|
||||
|
|
|
|||
|
|
@ -60,7 +60,7 @@ import org.springframework.context.access.ContextSingletonBeanFactoryLocator;
|
|||
*
|
||||
* <p><b>WARNING: Do not define the same bean as Spring-managed bean and as
|
||||
* EJB3 session bean in the same deployment unit.</b> In particular, be
|
||||
* careful when using the {@code <context:component-scan>} feature
|
||||
* careful when using the {@code <context:component-scan>} feature
|
||||
* in combination with the deployment of Spring-based EJB3 session beans:
|
||||
* Make sure that the EJB3 session beans are <i>not</i> autodetected as
|
||||
* Spring-managed beans as well, using appropriate package restrictions.
|
||||
|
|
|
|||
|
|
@ -34,8 +34,8 @@ import org.springframework.util.StringUtils;
|
|||
import org.springframework.util.xml.DomUtils;
|
||||
|
||||
/**
|
||||
* BeanDefinitionParser implementation for the '{@code <lang:groovy/>}',
|
||||
* '{@code <lang:jruby/>}' and '{@code <lang:bsh/>}' tags.
|
||||
* BeanDefinitionParser implementation for the '{@code <lang:groovy/>}',
|
||||
* '{@code <lang:jruby/>}' and '{@code <lang:bsh/>}' tags.
|
||||
* Allows for objects written using dynamic languages to be easily exposed with
|
||||
* the {@link org.springframework.beans.factory.BeanFactory}.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ import org.springframework.beans.factory.xml.ParserContext;
|
|||
import org.springframework.util.StringUtils;
|
||||
|
||||
/**
|
||||
* Parser for the JMS {@code <jca-listener-container>} element.
|
||||
* Parser for the JMS {@code <jca-listener-container>} element.
|
||||
*
|
||||
* @author Juergen Hoeller
|
||||
* @author Stephane Nicoll
|
||||
|
|
|
|||
|
|
@ -28,7 +28,7 @@ import org.springframework.beans.factory.xml.ParserContext;
|
|||
import org.springframework.util.StringUtils;
|
||||
|
||||
/**
|
||||
* Parser for the JMS {@code <listener-container>} element.
|
||||
* Parser for the JMS {@code <listener-container>} element.
|
||||
*
|
||||
* @author Mark Fisher
|
||||
* @author Juergen Hoeller
|
||||
|
|
|
|||
|
|
@ -173,7 +173,7 @@ public class LocalContainerEntityManagerFactoryBean extends AbstractEntityManage
|
|||
}
|
||||
|
||||
/**
|
||||
* Specify one or more mapping resources (equivalent to {@code <mapping-file>}
|
||||
* Specify one or more mapping resources (equivalent to {@code <mapping-file>}
|
||||
* entries in {@code persistence.xml}) for the default persistence unit.
|
||||
* Can be used on its own or in combination with entity scanning in the classpath,
|
||||
* in both cases avoiding {@code persistence.xml}.
|
||||
|
|
|
|||
|
|
@ -234,7 +234,7 @@ public class DefaultPersistenceUnitManager
|
|||
}
|
||||
|
||||
/**
|
||||
* Specify one or more mapping resources (equivalent to {@code <mapping-file>}
|
||||
* Specify one or more mapping resources (equivalent to {@code <mapping-file>}
|
||||
* entries in {@code persistence.xml}) for the default persistence unit.
|
||||
* Can be used on its own or in combination with entity scanning in the classpath,
|
||||
* in both cases avoiding {@code persistence.xml}.
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ import org.w3c.dom.Element;
|
|||
import org.springframework.beans.factory.xml.AbstractSimpleBeanDefinitionParser;
|
||||
|
||||
/**
|
||||
* Parser for the {@code <oxm:castor-marshaller/>} element.
|
||||
* Parser for the {@code <oxm:castor-marshaller/>} element.
|
||||
*
|
||||
* @author Jakub Narloch
|
||||
* @since 3.1
|
||||
|
|
|
|||
|
|
@ -300,10 +300,10 @@ public class XStreamMarshaller extends AbstractMarshaller implements Initializin
|
|||
|
||||
/**
|
||||
* Set the types to use XML attributes for. The given map can contain
|
||||
* either {@code <String, Class>} pairs, in which case
|
||||
* either {@code <String, Class>} pairs, in which case
|
||||
* {@link XStream#useAttributeFor(String, Class)} is called.
|
||||
* Alternatively, the map can contain {@code <Class, String>}
|
||||
* or {@code <Class, List<String>>} pairs, which results
|
||||
* Alternatively, the map can contain {@code <Class, String>}
|
||||
* or {@code <Class, List<String>>} pairs, which results
|
||||
* in {@link XStream#useAttributeFor(Class, String)} calls.
|
||||
*/
|
||||
public void setUseAttributeFor(Map<?, ?> useAttributeFor) {
|
||||
|
|
|
|||
|
|
@ -29,8 +29,8 @@ import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
|
|||
* to declaratively manage transactions.
|
||||
*
|
||||
* <p>One approach uses transaction semantics defined in XML using the
|
||||
* {@code <tx:advice>} elements, the other uses annotations
|
||||
* in combination with the {@code <tx:annotation-driven>} element.
|
||||
* {@code <tx:advice>} elements, the other uses annotations
|
||||
* in combination with the {@code <tx:annotation-driven>} element.
|
||||
* Both approached are detailed to great extent in the Spring reference manual.
|
||||
*
|
||||
* @author Rob Harrop
|
||||
|
|
|
|||
|
|
@ -86,7 +86,7 @@ public abstract class AbstractRequestLoggingFilter extends OncePerRequestFilter
|
|||
|
||||
/**
|
||||
* Set whether the query string should be included in the log message.
|
||||
* <p>Should be configured using an {@code <init-param>} for parameter name
|
||||
* <p>Should be configured using an {@code <init-param>} for parameter name
|
||||
* "includeQueryString" in the filter definition in {@code web.xml}.
|
||||
*/
|
||||
public void setIncludeQueryString(boolean includeQueryString) {
|
||||
|
|
@ -103,7 +103,7 @@ public abstract class AbstractRequestLoggingFilter extends OncePerRequestFilter
|
|||
/**
|
||||
* Set whether the client address and session id should be included in the
|
||||
* log message.
|
||||
* <p>Should be configured using an {@code <init-param>} for parameter name
|
||||
* <p>Should be configured using an {@code <init-param>} for parameter name
|
||||
* "includeClientInfo" in the filter definition in {@code web.xml}.
|
||||
*/
|
||||
public void setIncludeClientInfo(boolean includeClientInfo) {
|
||||
|
|
@ -120,7 +120,7 @@ public abstract class AbstractRequestLoggingFilter extends OncePerRequestFilter
|
|||
|
||||
/**
|
||||
* Set whether the request payload (body) should be included in the log message.
|
||||
* <p>Should be configured using an {@code <init-param>} for parameter name
|
||||
* <p>Should be configured using an {@code <init-param>} for parameter name
|
||||
* "includePayload" in the filter definition in {@code web.xml}.
|
||||
*/
|
||||
|
||||
|
|
|
|||
|
|
@ -149,7 +149,7 @@ public abstract class AbstractMultiCheckedElementTag extends AbstractCheckedElem
|
|||
/**
|
||||
* Set the HTML element used to enclose the
|
||||
* '{@code input type="checkbox/radio"}' tag.
|
||||
* <p>Defaults to an HTML '{@code <span/>}' tag.
|
||||
* <p>Defaults to an HTML '{@code <span/>}' tag.
|
||||
*/
|
||||
public void setElement(String element) {
|
||||
Assert.hasText(element, "'element' cannot be null or blank");
|
||||
|
|
|
|||
|
|
@ -72,7 +72,7 @@ public class ErrorsTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
|
||||
/**
|
||||
* Set the HTML element must be used to render the error messages.
|
||||
* <p>Defaults to an HTML '{@code <span/>}' tag.
|
||||
* <p>Defaults to an HTML '{@code <span/>}' tag.
|
||||
*/
|
||||
public void setElement(String element) {
|
||||
Assert.hasText(element, "'element' cannot be null or blank");
|
||||
|
|
@ -88,7 +88,7 @@ public class ErrorsTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
|
||||
/**
|
||||
* Set the delimiter to be used between error messages.
|
||||
* <p>Defaults to an HTML '{@code <br/>}' tag.
|
||||
* <p>Defaults to an HTML '{@code <br/>}' tag.
|
||||
*/
|
||||
public void setDelimiter(String delimiter) {
|
||||
this.delimiter = delimiter;
|
||||
|
|
@ -105,7 +105,7 @@ public class ErrorsTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
/**
|
||||
* Get the value for the HTML '{@code id}' attribute.
|
||||
* <p>Appends '{@code .errors}' to the value returned by {@link #getPropertyPath()}
|
||||
* or to the model attribute name if the {@code <form:errors/>} tag's
|
||||
* or to the model attribute name if the {@code <form:errors/>} tag's
|
||||
* '{@code path}' attribute has been omitted.
|
||||
* @return the value for the HTML '{@code id}' attribute
|
||||
* @see #getPropertyPath()
|
||||
|
|
|
|||
|
|
@ -76,12 +76,12 @@ public class OptionTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
|
||||
|
||||
/**
|
||||
* The 'value' attribute of the rendered HTML {@code <option>} tag.
|
||||
* The 'value' attribute of the rendered HTML {@code <option>} tag.
|
||||
*/
|
||||
private Object value;
|
||||
|
||||
/**
|
||||
* The text body of the rendered HTML {@code <option>} tag.
|
||||
* The text body of the rendered HTML {@code <option>} tag.
|
||||
*/
|
||||
private String label;
|
||||
|
||||
|
|
@ -93,14 +93,14 @@ public class OptionTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
|
||||
|
||||
/**
|
||||
* Set the 'value' attribute of the rendered HTML {@code <option>} tag.
|
||||
* Set the 'value' attribute of the rendered HTML {@code <option>} tag.
|
||||
*/
|
||||
public void setValue(Object value) {
|
||||
this.value = value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the 'value' attribute of the rendered HTML {@code <option>} tag.
|
||||
* Get the 'value' attribute of the rendered HTML {@code <option>} tag.
|
||||
*/
|
||||
protected Object getValue() {
|
||||
return this.value;
|
||||
|
|
@ -121,7 +121,7 @@ public class OptionTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
}
|
||||
|
||||
/**
|
||||
* Set the text body of the rendered HTML {@code <option>} tag.
|
||||
* Set the text body of the rendered HTML {@code <option>} tag.
|
||||
* <p>May be a runtime expression.
|
||||
*/
|
||||
public void setLabel(String label) {
|
||||
|
|
@ -130,7 +130,7 @@ public class OptionTag extends AbstractHtmlElementBodyTag implements BodyTag {
|
|||
}
|
||||
|
||||
/**
|
||||
* Get the text body of the rendered HTML {@code <option>} tag.
|
||||
* Get the text body of the rendered HTML {@code <option>} tag.
|
||||
*/
|
||||
protected String getLabel() {
|
||||
return this.label;
|
||||
|
|
|
|||
Loading…
Reference in New Issue