|
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