Permalink
Browse files

Replace <code> with {@code} throughout Javadoc

Issue: SPR-10128
  • Loading branch information...
1 parent 8597ec2 commit 9540d2c81b93b9062faf79d4df998525f3dedb7c @cbeams cbeams committed Dec 18, 2012
Showing 1,503 changed files with 8,001 additions and 8,060 deletions.
@@ -50,7 +50,7 @@
* (for example, creating a mixin) or shared with all instances of
* the advised class obtained from the same Spring bean factory.
* <p><b>Note that this method is not currently used by the framework.</b>
- * Typical Advisor implementations always return <code>true</code>.
+ * Typical Advisor implementations always return {@code true}.
* Use singleton/prototype bean definitions or appropriate programmatic
* proxy creation to ensure that Advisors have the correct lifecycle model.
* @return whether this advice is associated with a particular target instance
@@ -33,7 +33,7 @@
* @param returnValue the value returned by the method, if any
* @param method method being invoked
* @param args arguments to the method
- * @param target target of the method invocation. May be <code>null</code>.
+ * @param target target of the method invocation. May be {@code null}.
* @throws Throwable if this object wishes to abort the call.
* Any exception thrown will be returned to the caller if it's
* allowed by the method signature. Otherwise the exception
@@ -33,10 +33,10 @@
* instead of the 2-arg {@link #matches(java.lang.reflect.Method, Class)} method
* if the caller supports the extended IntroductionAwareMethodMatcher interface.
* @param method the candidate method
- * @param targetClass the target class (may be <code>null</code>, in which case
+ * @param targetClass the target class (may be {@code null}, in which case
* the candidate class must be taken to be the method's declaring class)
- * @param hasIntroductions <code>true</code> if the object on whose behalf we are
- * asking is the subject on one or more introductions; <code>false</code> otherwise
+ * @param hasIntroductions {@code true} if the object on whose behalf we are
+ * asking is the subject on one or more introductions; {@code false} otherwise
* @return whether or not this method matches statically
*/
boolean matches(Method method, Class targetClass, boolean hasIntroductions);
@@ -33,7 +33,7 @@
* Callback before a given method is invoked.
* @param method method being invoked
* @param args arguments to the method
- * @param target target of the method invocation. May be <code>null</code>.
+ * @param target target of the method invocation. May be {@code null}.
* @throws Throwable if this object wishes to abort the call.
* Any exception thrown will be returned to the caller if it's
* allowed by the method signature. Otherwise the exception
@@ -26,15 +26,15 @@
* also makes arguments for a particular call available, and any effects of running
* previous advice applying to the joinpoint.
*
- * <p>If an implementation returns <code>false</code> from its {@link #isRuntime()}
+ * <p>If an implementation returns {@code false} from its {@link #isRuntime()}
* method, evaluation can be performed statically, and the result will be the same
* for all invocations of this method, whatever their arguments. This means that
- * if the {@link #isRuntime()} method returns <code>false</code>, the 3-arg
+ * if the {@link #isRuntime()} method returns {@code false}, the 3-arg
* {@link #matches(java.lang.reflect.Method, Class, Object[])} method will never be invoked.
*
- * <p>If an implementation returns <code>true</code> from its 2-arg
+ * <p>If an implementation returns {@code true} from its 2-arg
* {@link #matches(java.lang.reflect.Method, Class)} method and its {@link #isRuntime()} method
- * returns <code>true</code>, the 3-arg {@link #matches(java.lang.reflect.Method, Class, Object[])}
+ * returns {@code true}, the 3-arg {@link #matches(java.lang.reflect.Method, Class, Object[])}
* method will be invoked <i>immediately before each potential execution of the related advice</i>,
* to decide whether the advice should run. All previous advice, such as earlier interceptors
* in an interceptor chain, will have run, so any state changes they have produced in
@@ -49,11 +49,11 @@
/**
* Perform static checking whether the given method matches. If this
- * returns <code>false</code> or if the {@link #isRuntime()} method
- * returns <code>false</code>, no runtime check (i.e. no.
+ * returns {@code false} or if the {@link #isRuntime()} method
+ * returns {@code false}, no runtime check (i.e. no.
* {@link #matches(java.lang.reflect.Method, Class, Object[])} call) will be made.
* @param method the candidate method
- * @param targetClass the target class (may be <code>null</code>, in which case
+ * @param targetClass the target class (may be {@code null}, in which case
* the candidate class must be taken to be the method's declaring class)
* @return whether or not this method matches statically
*/
@@ -62,7 +62,7 @@
/**
* Is this MethodMatcher dynamic, that is, must a final call be made on the
* {@link #matches(java.lang.reflect.Method, Class, Object[])} method at
- * runtime even if the 2-arg matches method returns <code>true</code>?
+ * runtime even if the 2-arg matches method returns {@code true}?
* <p>Can be invoked when an AOP proxy is created, and need not be invoked
* again before each method invocation,
* @return whether or not a runtime match via the 3-arg
@@ -75,12 +75,12 @@
* Check whether there a runtime (dynamic) match for this method,
* which must have matched statically.
* <p>This method is invoked only if the 2-arg matches method returns
- * <code>true</code> for the given method and target class, and if the
- * {@link #isRuntime()} method returns <code>true</code>. Invoked
+ * {@code true} for the given method and target class, and if the
+ * {@link #isRuntime()} method returns {@code true}. Invoked
* immediately before potential running of the advice, after any
* advice earlier in the advice chain has run.
* @param method the candidate method
- * @param targetClass the target class (may be <code>null</code>, in which case
+ * @param targetClass the target class (may be {@code null}, in which case
* the candidate class must be taken to be the method's declaring class)
* @param args arguments to the method
* @return whether there's a runtime match
@@ -34,13 +34,13 @@
/**
* Return the ClassFilter for this pointcut.
- * @return the ClassFilter (never <code>null</code>)
+ * @return the ClassFilter (never {@code null})
*/
ClassFilter getClassFilter();
/**
* Return the MethodMatcher for this pointcut.
- * @return the MethodMatcher (never <code>null</code>)
+ * @return the MethodMatcher (never {@code null})
*/
MethodMatcher getMethodMatcher();
@@ -40,22 +40,22 @@
Object getProxy();
/**
- * Create a clone of this object. If cloning is done before <code>proceed()</code>
- * is invoked on this object, <code>proceed()</code> can be invoked once per clone
+ * Create a clone of this object. If cloning is done before {@code proceed()}
+ * is invoked on this object, {@code proceed()} can be invoked once per clone
* to invoke the joinpoint (and the rest of the advice chain) more than once.
* @return an invocable clone of this invocation.
- * <code>proceed()</code> can be called once per clone.
+ * {@code proceed()} can be called once per clone.
*/
MethodInvocation invocableClone();
/**
- * Create a clone of this object. If cloning is done before <code>proceed()</code>
- * is invoked on this object, <code>proceed()</code> can be invoked once per clone
+ * Create a clone of this object. If cloning is done before {@code proceed()}
+ * is invoked on this object, {@code proceed()} can be invoked once per clone
* to invoke the joinpoint (and the rest of the advice chain) more than once.
* @param arguments the arguments that the cloned invocation is supposed to use,
* overriding the original arguments
* @return an invocable clone of this invocation.
- * <code>proceed()</code> can be called once per clone.
+ * {@code proceed()} can be called once per clone.
*/
MethodInvocation invocableClone(Object[] arguments);
@@ -71,14 +71,14 @@
* <p>Such attributes are not used within the AOP framework itself. They are
* just kept as part of the invocation object, for use in special interceptors.
* @param key the name of the attribute
- * @param value the value of the attribute, or <code>null</code> to reset it
+ * @param value the value of the attribute, or {@code null} to reset it
*/
void setUserAttribute(String key, Object value);
/**
* Return the value of the specified user attribute.
* @param key the name of the attribute
- * @return the value of the attribute, or <code>null</code> if not set
+ * @return the value of the attribute, or {@code null} if not set
* @see #setUserAttribute
*/
Object getUserAttribute(String key);
@@ -32,7 +32,7 @@
/**
* Return the target class behind the implementing object
* (typically a proxy configuration or an actual proxy).
- * @return the target Class, or <code>null</code> if not known
+ * @return the target Class, or {@code null} if not known
*/
Class<?> getTargetClass();
@@ -17,25 +17,25 @@
package org.springframework.aop;
/**
- * A <code>TargetSource</code> is used to obtain the current "target" of
+ * A {@code TargetSource} is used to obtain the current "target" of
* an AOP invocation, which will be invoked via reflection if no around
* advice chooses to end the interceptor chain itself.
*
- * <p>If a <code>TargetSource</code> is "static", it will always return
+ * <p>If a {@code TargetSource} is "static", it will always return
* the same target, allowing optimizations in the AOP framework. Dynamic
* target sources can support pooling, hot swapping, etc.
*
* <p>Application developers don't usually need to work with
- * <code>TargetSources</code> directly: this is an AOP framework interface.
+ * {@code TargetSources} directly: this is an AOP framework interface.
*
* @author Rod Johnson
*/
public interface TargetSource extends TargetClassAware {
/**
* Return the type of targets returned by this {@link TargetSource}.
- * <p>Can return <code>null</code>, although certain usages of a
- * <code>TargetSource</code> might just work with a predetermined
+ * <p>Can return {@code null}, although certain usages of a
+ * {@code TargetSource} might just work with a predetermined
* target class.
* @return the type of targets returned by this {@link TargetSource}
*/
@@ -46,7 +46,7 @@
* <p>In that case, there will be no need to invoke
* {@link #releaseTarget(Object)}, and the AOP framework can cache
* the return value of {@link #getTarget()}.
- * @return <code>true</code> if the target is immutable
+ * @return {@code true} if the target is immutable
* @see #getTarget
*/
boolean isStatic();
@@ -40,7 +40,7 @@ public boolean matches(Class clazz) {
/**
* Required to support serialization. Replaces with canonical
* instance on deserialization, protecting Singleton pattern.
- * Alternative to overriding <code>equals()</code>.
+ * Alternative to overriding {@code equals()}.
*/
private Object readResolve() {
return INSTANCE;
@@ -50,7 +50,7 @@ public boolean matches(Method method, Class targetClass, Object[] args) {
/**
* Required to support serialization. Replaces with canonical
* instance on deserialization, protecting Singleton pattern.
- * Alternative to overriding <code>equals()</code>.
+ * Alternative to overriding {@code equals()}.
*/
private Object readResolve() {
return INSTANCE;
@@ -44,7 +44,7 @@ public MethodMatcher getMethodMatcher() {
/**
* Required to support serialization. Replaces with canonical
* instance on deserialization, protecting Singleton pattern.
- * Alternative to overriding <code>equals()</code>.
+ * Alternative to overriding {@code equals()}.
*/
private Object readResolve() {
return INSTANCE;
@@ -347,8 +347,8 @@ private boolean isVariableName(String name) {
* on subsequent advice invocations can be as fast as possible.
* <p>If the first argument is of type JoinPoint or ProceedingJoinPoint then we
* pass a JoinPoint in that position (ProceedingJoinPoint for around advice).
- * <p>If the first argument is of type <code>JoinPoint.StaticPart</code>
- * then we pass a <code>JoinPoint.StaticPart</code> in that position.
+ * <p>If the first argument is of type {@code JoinPoint.StaticPart}
+ * then we pass a {@code JoinPoint.StaticPart} in that position.
* <p>Remaining arguments have to be bound by pointcut evaluation at
* a given join point. We will get back a map from argument name to
* value. We need to calculate which advice parameter needs to be bound
@@ -34,13 +34,13 @@
/**
* Create an instance of this factory's aspect.
- * @return the aspect instance (never <code>null</code>)
+ * @return the aspect instance (never {@code null})
*/
Object getAspectInstance();
/**
* Expose the aspect class loader that this factory uses.
- * @return the aspect class loader (never <code>null</code>)
+ * @return the aspect class loader (never {@code null})
*/
ClassLoader getAspectClassLoader();
Oops, something went wrong.

0 comments on commit 9540d2c

Please sign in to comment.