|
1 | 1 | /*
|
2 |
| - * Copyright 2002-2012 the original author or authors. |
| 2 | + * Copyright 2002-2018 the original author or authors. |
3 | 3 | *
|
4 | 4 | * Licensed under the Apache License, Version 2.0 (the "License");
|
5 | 5 | * you may not use this file except in compliance with the License.
|
|
36 | 36 | public interface ParameterNameDiscoverer {
|
37 | 37 |
|
38 | 38 | /**
|
39 |
| - * Return parameter names for this method, |
40 |
| - * or {@code null} if they cannot be determined. |
41 |
| - * @param method method to find parameter names for |
| 39 | + * Return parameter names for a method, or {@code null} if they cannot be determined. |
| 40 | + * <p>Individual entries in the array may be {@code null} if parameter names are only |
| 41 | + * available for some parameters of the given method but not for others. However, |
| 42 | + * it is recommended to use stub parameter names instead wherever feasible. |
| 43 | + * @param method the method to find parameter names for |
42 | 44 | * @return an array of parameter names if the names can be resolved,
|
43 | 45 | * or {@code null} if they cannot
|
44 | 46 | */
|
45 | 47 | @Nullable
|
46 | 48 | String[] getParameterNames(Method method);
|
47 | 49 |
|
48 | 50 | /**
|
49 |
| - * Return parameter names for this constructor, |
50 |
| - * or {@code null} if they cannot be determined. |
51 |
| - * @param ctor constructor to find parameter names for |
| 51 | + * Return parameter names for a constructor, or {@code null} if they cannot be determined. |
| 52 | + * <p>Individual entries in the array may be {@code null} if parameter names are only |
| 53 | + * available for some parameters of the given constructor but not for others. However, |
| 54 | + * it is recommended to use stub parameter names instead wherever feasible. |
| 55 | + * @param ctor the constructor to find parameter names for |
52 | 56 | * @return an array of parameter names if the names can be resolved,
|
53 | 57 | * or {@code null} if they cannot
|
54 | 58 | */
|
|
0 commit comments