Re: svn commit: r1447019 - /commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

Re: svn commit: r1447019 - /commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java

Simone Tripodi-2
unneeded, I suggest you to read our mate Stephen's blog about that:
http://blog.joda.org/2012/11/javadoc-coding-standards.html

HTH,
-Simo

http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/


On Sun, Feb 17, 2013 at 2:18 PM,  <[hidden email]> wrote:

> Author: britter
> Date: Sun Feb 17 13:17:59 2013
> New Revision: 1447019
>
> URL: http://svn.apache.org/r1447019
> Log:
> Wrap JavaDoc paragraphs in <p>-tags
>
> Modified:
>     commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
>
> Modified: commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
> URL: http://svn.apache.org/viewvc/commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java?rev=1447019&r1=1447018&r2=1447019&view=diff
> ==============================================================================
> --- commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java (original)
> +++ commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java Sun Feb 17 13:17:59 2013
> @@ -20,7 +20,9 @@ package org.apache.commons.beanutils2;
>   */
>
>  /**
> + * <p>
>   * Provides access to constructors and static methods on a class.
> + * </p>
>   *
>   * @param <B> The type modeled by this {@code ClassAccessor}.
>   */
> @@ -30,9 +32,11 @@ public interface ClassAccessor<B>
>      // constructors
>
>      /**
> +     * <p>
>       * Creates a new instance of type {@code B} by calling the parameterless constructor of the wrapped class.
> +     * </p>
>       *
> -     * @param<B> the type of the new instance
> +     * @param <B> the type of the new instance
>       * @return a {@link BeanAccessor} that wraps the new instance.
>       * @throws BeanInstantiationException if the class wrapped by this {@code ClassAccessor} is not instantiable (for
>       *             example if it is a primitive type).
> @@ -44,8 +48,10 @@ public interface ClassAccessor<B>
>      BeanAccessor<B> newInstance();
>
>      /**
> +     * <p>
>       * Invokes the constructor with the parameter list represented by {@code arguments} on the wrapped class. Primitive
>       * types may be converted to wrapper types and vice versa to match the methods signature.
> +     * </p>
>       *
>       * @param arguments the list of arguments to invoke the constructor with. None of the {@code Argument} objects must
>       *            be {@code null}. If you want to pass {@code null} to the constructor use
> @@ -60,8 +66,10 @@ public interface ClassAccessor<B>
>      BeanAccessor<B> invokeConstructor( Argument<?>... arguments );
>
>      /**
> +     * <p>
>       * Invokes the constructor with the parameter list represented by {@code arguments} on the wrapped class. Invoking
>       * an exact constructor in this context means to not perform any type conversations during invocation.
> +     * </p>
>       *
>       * @param arguments the list of arguments to invoke the constructor with. None of the {@code Argument} objects must
>       *            be {@code null}. If you want to pass {@code null} to the constructor use
> @@ -79,7 +87,9 @@ public interface ClassAccessor<B>
>      // bean properties
>
>      /**
> +     * <p>
>       * Provides access to the {@link BeanProperties} defined by the wrapped class.
> +     * </p>
>       *
>       * @return the {@link BeanProperties} for the wrapped class.
>       */
> @@ -88,8 +98,10 @@ public interface ClassAccessor<B>
>      // static methods invocation
>
>      /**
> +     * <p>
>       * Invokes the method with name {@code methodName} on the wrapped class. Primitive types may be converted to wrapper
>       * types and vice versa to match the methods signature.
> +     * </p>
>       *
>       * @param methodName the name of the method to invoke. Must not be {@code null}!
>       * @return the {@link ArgumentsAccessor} for this method invocation.
> @@ -97,8 +109,10 @@ public interface ClassAccessor<B>
>      ArgumentsAccessor invokeStatic( String methodName );
>
>      /**
> +     * <p>
>       * Invokes the method with name {@code methodName} on the wrapped class. Invoking an exact method in this context
>       * means to not perform any type conversations during invocation.
> +     * </p>
>       *
>       * @param methodName the name of the method to invoke. Must not be {@code null}!
>       * @return the {@link ArgumentsAccessor} for this method invocation.
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: svn commit: r1447019 - /commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java

Benedikt Ritter-4
Ciao Simo,

thanks a lot! I adopted the <p>-tags from BU1. I was wondering why they are
used in that way in BU1. Should have asked the ML. I'll change this tonight!

Benedikt


2013/2/17 Simone Tripodi <[hidden email]>

> unneeded, I suggest you to read our mate Stephen's blog about that:
> http://blog.joda.org/2012/11/javadoc-coding-standards.html
>
> HTH,
> -Simo
>
> http://people.apache.org/~simonetripodi/
> http://simonetripodi.livejournal.com/
> http://twitter.com/simonetripodi
> http://www.99soft.org/
>
>
> On Sun, Feb 17, 2013 at 2:18 PM,  <[hidden email]> wrote:
> > Author: britter
> > Date: Sun Feb 17 13:17:59 2013
> > New Revision: 1447019
> >
> > URL: http://svn.apache.org/r1447019
> > Log:
> > Wrap JavaDoc paragraphs in <p>-tags
> >
> > Modified:
> >
> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
> >
> > Modified:
> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
> > URL:
> http://svn.apache.org/viewvc/commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java?rev=1447019&r1=1447018&r2=1447019&view=diff
> >
> ==============================================================================
> > ---
> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
> (original)
> > +++
> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
> Sun Feb 17 13:17:59 2013
> > @@ -20,7 +20,9 @@ package org.apache.commons.beanutils2;
> >   */
> >
> >  /**
> > + * <p>
> >   * Provides access to constructors and static methods on a class.
> > + * </p>
> >   *
> >   * @param <B> The type modeled by this {@code ClassAccessor}.
> >   */
> > @@ -30,9 +32,11 @@ public interface ClassAccessor<B>
> >      // constructors
> >
> >      /**
> > +     * <p>
> >       * Creates a new instance of type {@code B} by calling the
> parameterless constructor of the wrapped class.
> > +     * </p>
> >       *
> > -     * @param<B> the type of the new instance
> > +     * @param <B> the type of the new instance
> >       * @return a {@link BeanAccessor} that wraps the new instance.
> >       * @throws BeanInstantiationException if the class wrapped by this
> {@code ClassAccessor} is not instantiable (for
> >       *             example if it is a primitive type).
> > @@ -44,8 +48,10 @@ public interface ClassAccessor<B>
> >      BeanAccessor<B> newInstance();
> >
> >      /**
> > +     * <p>
> >       * Invokes the constructor with the parameter list represented by
> {@code arguments} on the wrapped class. Primitive
> >       * types may be converted to wrapper types and vice versa to match
> the methods signature.
> > +     * </p>
> >       *
> >       * @param arguments the list of arguments to invoke the constructor
> with. None of the {@code Argument} objects must
> >       *            be {@code null}. If you want to pass {@code null} to
> the constructor use
> > @@ -60,8 +66,10 @@ public interface ClassAccessor<B>
> >      BeanAccessor<B> invokeConstructor( Argument<?>... arguments );
> >
> >      /**
> > +     * <p>
> >       * Invokes the constructor with the parameter list represented by
> {@code arguments} on the wrapped class. Invoking
> >       * an exact constructor in this context means to not perform any
> type conversations during invocation.
> > +     * </p>
> >       *
> >       * @param arguments the list of arguments to invoke the constructor
> with. None of the {@code Argument} objects must
> >       *            be {@code null}. If you want to pass {@code null} to
> the constructor use
> > @@ -79,7 +87,9 @@ public interface ClassAccessor<B>
> >      // bean properties
> >
> >      /**
> > +     * <p>
> >       * Provides access to the {@link BeanProperties} defined by the
> wrapped class.
> > +     * </p>
> >       *
> >       * @return the {@link BeanProperties} for the wrapped class.
> >       */
> > @@ -88,8 +98,10 @@ public interface ClassAccessor<B>
> >      // static methods invocation
> >
> >      /**
> > +     * <p>
> >       * Invokes the method with name {@code methodName} on the wrapped
> class. Primitive types may be converted to wrapper
> >       * types and vice versa to match the methods signature.
> > +     * </p>
> >       *
> >       * @param methodName the name of the method to invoke. Must not be
> {@code null}!
> >       * @return the {@link ArgumentsAccessor} for this method invocation.
> > @@ -97,8 +109,10 @@ public interface ClassAccessor<B>
> >      ArgumentsAccessor invokeStatic( String methodName );
> >
> >      /**
> > +     * <p>
> >       * Invokes the method with name {@code methodName} on the wrapped
> class. Invoking an exact method in this context
> >       * means to not perform any type conversations during invocation.
> > +     * </p>
> >       *
> >       * @param methodName the name of the method to invoke. Must not be
> {@code null}!
> >       * @return the {@link ArgumentsAccessor} for this method invocation.
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>


--
http://people.apache.org/~britter/
http://www.systemoutprintln.de/
http://twitter.com/BenediktRitter
http://github.com/britter
Reply | Threaded
Open this post in threaded view
|

Re: svn commit: r1447019 - /commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java

Simone Tripodi-2
Hallo Bene,

don't worry, the good thing is we have an SCM that allows us reviewing
modifications, so we can discuss about modifications :)

Alles gute!
-Simo

http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/


On Mon, Feb 18, 2013 at 9:11 AM, Benedikt Ritter <[hidden email]> wrote:

> Ciao Simo,
>
> thanks a lot! I adopted the <p>-tags from BU1. I was wondering why they are
> used in that way in BU1. Should have asked the ML. I'll change this tonight!
>
> Benedikt
>
>
> 2013/2/17 Simone Tripodi <[hidden email]>
>
>> unneeded, I suggest you to read our mate Stephen's blog about that:
>> http://blog.joda.org/2012/11/javadoc-coding-standards.html
>>
>> HTH,
>> -Simo
>>
>> http://people.apache.org/~simonetripodi/
>> http://simonetripodi.livejournal.com/
>> http://twitter.com/simonetripodi
>> http://www.99soft.org/
>>
>>
>> On Sun, Feb 17, 2013 at 2:18 PM,  <[hidden email]> wrote:
>> > Author: britter
>> > Date: Sun Feb 17 13:17:59 2013
>> > New Revision: 1447019
>> >
>> > URL: http://svn.apache.org/r1447019
>> > Log:
>> > Wrap JavaDoc paragraphs in <p>-tags
>> >
>> > Modified:
>> >
>> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
>> >
>> > Modified:
>> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
>> > URL:
>> http://svn.apache.org/viewvc/commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java?rev=1447019&r1=1447018&r2=1447019&view=diff
>> >
>> ==============================================================================
>> > ---
>> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
>> (original)
>> > +++
>> commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java
>> Sun Feb 17 13:17:59 2013
>> > @@ -20,7 +20,9 @@ package org.apache.commons.beanutils2;
>> >   */
>> >
>> >  /**
>> > + * <p>
>> >   * Provides access to constructors and static methods on a class.
>> > + * </p>
>> >   *
>> >   * @param <B> The type modeled by this {@code ClassAccessor}.
>> >   */
>> > @@ -30,9 +32,11 @@ public interface ClassAccessor<B>
>> >      // constructors
>> >
>> >      /**
>> > +     * <p>
>> >       * Creates a new instance of type {@code B} by calling the
>> parameterless constructor of the wrapped class.
>> > +     * </p>
>> >       *
>> > -     * @param<B> the type of the new instance
>> > +     * @param <B> the type of the new instance
>> >       * @return a {@link BeanAccessor} that wraps the new instance.
>> >       * @throws BeanInstantiationException if the class wrapped by this
>> {@code ClassAccessor} is not instantiable (for
>> >       *             example if it is a primitive type).
>> > @@ -44,8 +48,10 @@ public interface ClassAccessor<B>
>> >      BeanAccessor<B> newInstance();
>> >
>> >      /**
>> > +     * <p>
>> >       * Invokes the constructor with the parameter list represented by
>> {@code arguments} on the wrapped class. Primitive
>> >       * types may be converted to wrapper types and vice versa to match
>> the methods signature.
>> > +     * </p>
>> >       *
>> >       * @param arguments the list of arguments to invoke the constructor
>> with. None of the {@code Argument} objects must
>> >       *            be {@code null}. If you want to pass {@code null} to
>> the constructor use
>> > @@ -60,8 +66,10 @@ public interface ClassAccessor<B>
>> >      BeanAccessor<B> invokeConstructor( Argument<?>... arguments );
>> >
>> >      /**
>> > +     * <p>
>> >       * Invokes the constructor with the parameter list represented by
>> {@code arguments} on the wrapped class. Invoking
>> >       * an exact constructor in this context means to not perform any
>> type conversations during invocation.
>> > +     * </p>
>> >       *
>> >       * @param arguments the list of arguments to invoke the constructor
>> with. None of the {@code Argument} objects must
>> >       *            be {@code null}. If you want to pass {@code null} to
>> the constructor use
>> > @@ -79,7 +87,9 @@ public interface ClassAccessor<B>
>> >      // bean properties
>> >
>> >      /**
>> > +     * <p>
>> >       * Provides access to the {@link BeanProperties} defined by the
>> wrapped class.
>> > +     * </p>
>> >       *
>> >       * @return the {@link BeanProperties} for the wrapped class.
>> >       */
>> > @@ -88,8 +98,10 @@ public interface ClassAccessor<B>
>> >      // static methods invocation
>> >
>> >      /**
>> > +     * <p>
>> >       * Invokes the method with name {@code methodName} on the wrapped
>> class. Primitive types may be converted to wrapper
>> >       * types and vice versa to match the methods signature.
>> > +     * </p>
>> >       *
>> >       * @param methodName the name of the method to invoke. Must not be
>> {@code null}!
>> >       * @return the {@link ArgumentsAccessor} for this method invocation.
>> > @@ -97,8 +109,10 @@ public interface ClassAccessor<B>
>> >      ArgumentsAccessor invokeStatic( String methodName );
>> >
>> >      /**
>> > +     * <p>
>> >       * Invokes the method with name {@code methodName} on the wrapped
>> class. Invoking an exact method in this context
>> >       * means to not perform any type conversations during invocation.
>> > +     * </p>
>> >       *
>> >       * @param methodName the name of the method to invoke. Must not be
>> {@code null}!
>> >       * @return the {@link ArgumentsAccessor} for this method invocation.
>> >
>> >
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [hidden email]
>> For additional commands, e-mail: [hidden email]
>>
>>
>
>
> --
> http://people.apache.org/~britter/
> http://www.systemoutprintln.de/
> http://twitter.com/BenediktRitter
> http://github.com/britter

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]