-
Notifications
You must be signed in to change notification settings - Fork 2.4k
Added missing docs for batch.core and batch.core.configuration packages #4068
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
private final String exitDescription; | ||
|
||
/** | ||
* Constructor that accepts the exitCode and sets the exitDescription to an empty {@link String}. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Change exitCode and exitDescription to exit code and exit description (that is, say it in English rather than Java).
} | ||
|
||
/** | ||
* Constructor that establishes the exitCode and the exitDescription for the {@link ExitStatus}. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Change exitCode and exitDescription to exit code and exit description (that is, say it in English rather than Java).
* | ||
* @param job the enclosing {@link JobInstance} | ||
* @param jobParameters {@link JobParameters} instance for this JobExecution. | ||
* @param job The enclosing {@link JobInstance} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add a period at the end.
|
||
/** | ||
* Retrieve a list of exceptions. | ||
* @return The {@link List} of {@link Throwable}s. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
} | ||
|
||
/** | ||
* Constructor that is initialized with content of a {@link Map} that contains a string key and {@link JobParameter} value. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Change "with content" to "with the content".
*/ | ||
public static final String LONG_TYPE = "(long)"; | ||
|
||
private static final String DOUBLE_TYPE = "(double)"; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add a similar description for this one.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Aroo?
/** | ||
* | ||
* <p> | ||
* Implementation of {@link JobRepository} that stores JobInstances, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Change JobInstances to job instances. (English rather than Java. Also, unless there is an object named JobInstances, it's an error to use the term.
* | ||
* <p> | ||
* Implementation of {@link JobRepository} that stores JobInstances, | ||
* JobExecutions, and StepExecutions using the injected DAOs. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Change "JobExections" and "StepExecutions" to job executions and step executions (respectively). Same comment as the previous line about not referring to objects that don't exist.
These two aren't your fault, I know. However, since we're here....
} | ||
|
||
/** | ||
* Constructor that accepts the current job execution ID and {@link JobParameters}. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove "current".
} | ||
|
||
/** | ||
* Constructor that accepts the current job execution ID. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove "current".
517fe11
to
da9c74e
Compare
/** | ||
* Returns the {@link BatchConfigurer} if one is present in list. Create {@link BatchConfigurer} if configurers list is empty. | ||
* If more than one configurer is present in the list then an {@link IllegalStateException} is thrown. | ||
* If a {@link BatchConfigurer}, return it. If the configurers list is empty, create {@link BatchConfigurer}. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We need "exists" before the first comma. My bad, I think.
No description provided.