Javadocs cleanup

This commit is contained in:
Erik C. Thauvin 2023-10-28 12:32:22 -07:00
parent a72995f708
commit e9dede89bf
3 changed files with 28 additions and 27 deletions

View file

@ -61,9 +61,9 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Provides the destination file name that will be used for the archive creation.
* Provides the file name that will be used for the archive creation.
*
* @param name the war archive destination file name
* @param name the archive file name
* @return this operation instance
*/
public AbstractBootOperation destinationArchiveFileName(String name) {
@ -72,9 +72,9 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Retrieves the destination file name that will be used for the JAR creation.
* Retrieves the file name that will be used for the archive creation.
*
* @return the war Jar's destination file name
* @return the archive file name
*/
public String destinationArchiveFileName() {
return destinationArchiveFileName;
@ -83,7 +83,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
/**
* Retrieves the destination directory in which the JAR will be created.
*
* @return the JAR's destination directory
* @return the destination directory
*/
public File destinationDirectory() {
return destinationDirectory_;
@ -92,7 +92,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
/**
* Provides the destination directory in which the archive will be created.
*
* @param directory the war destination directory
* @param directory the destination directory
* @return this operation instance
*/
public AbstractBootOperation destinationDirectory(File directory) throws IOException {
@ -102,7 +102,8 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Part of the {@link #execute} operation, copy the {@code spring-boot-loader} archive content to the staging directory.
* Part of the {@link #execute} operation, copy the {@code spring-boot-loader} archive content to the staging
* directory.
*/
protected void executeCopyBootLoader(File stagingDirectory) throws FileUtilsErrorException {
if (launcherJars_.isEmpty()) {
@ -119,7 +120,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Part of the {@link #execute} operation, copy the {@code BOOT-INF} or {@code WEB-INF} classes.
* Part of the {@link #execute} operation, copy the {@code BOOT-INF} or {@code WEB-INF} classes.
*/
protected void executeCopyInfClassesFiles(File stagingInfDirectory) throws IOException {
var inf_classes_dir = new File(stagingInfDirectory, "classes");
@ -155,7 +156,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
stagingDirectory.exists()));
logger.fine(MessageFormat.format("Destination Directory: {0} (exists:{1})", destinationDirectory(),
destinationDirectory().exists()));
logger.fine(MessageFormat.format("Destination WAR: {0}", destinationArchiveFileName()));
logger.fine(MessageFormat.format("Destination Archive: {0}", destinationArchiveFileName()));
}
var out = new StringWriter();
@ -203,7 +204,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Provides library JARs that will be used for the archive creation.
* Provides JAR libraries that will be stored in {@code BOOT-INF} or {@code WEB-INF}.
*
* @param jars Java archive files
* @return this operation instance
@ -214,7 +215,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Provides library JARs that will be used for the archive creation.
* Provides JAR libraries that will be stored in {@code BOOT-INF} or {@code WEB-INF}.
*
* @param jar Java archive file
* @return this operation instance
@ -225,7 +226,7 @@ public abstract class AbstractBootOperation extends AbstractOperation<AbstractBo
}
/**
* Retrieves the library JARs in {@code BOOT-INF} or {@code WEB-INF}.
* Retrieves the JAR libraries in {@code BOOT-INF} or {@code WEB-INF}.
*/
public List<File> infLibs() {
return infLibs_;

View file

@ -37,9 +37,9 @@ public class BootJarOperation extends AbstractBootOperation {
private static final Logger LOGGER = Logger.getLogger(BootJarOperation.class.getName());
/**
* Provides the destination file name that will be used for the archive creation.
* Provides the destination file name that will be used for the JAR creation.
*
* @param name the war archive destination file name
* @param name the JAR destination file name
* @return this operation instance
*/
@Override
@ -48,9 +48,9 @@ public class BootJarOperation extends AbstractBootOperation {
}
/**
* Provides the destination directory in which the archive will be created.
* Provides the destination directory in which the JAR will be created.
*
* @param directory the war destination directory
* @param directory the JAR destination directory
* @return this operation instance
*/
@Override
@ -59,7 +59,7 @@ public class BootJarOperation extends AbstractBootOperation {
}
/**
* Provides library JARs that will be used for the JAR creation.
* Provides JAR libraries that will be used for the JAR creation.
*
* @param jars Java archive files
* @return this operation instance
@ -70,7 +70,7 @@ public class BootJarOperation extends AbstractBootOperation {
}
/**
* Provides library JARs that will be used for the JAR creation.
* Provides JAR libraries that will be used for the JAR creation.
*
* @param jar Java archive file
* @return this operation instance

View file

@ -29,7 +29,7 @@ import java.util.logging.Level;
import java.util.logging.Logger;
/**
* Builds and creates a Spring Boot web archive (WAR).
* Builds and creates a Spring Boot executable web archive (WAR).
*
* @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
* @since 1.0
@ -39,9 +39,9 @@ public class BootWarOperation extends AbstractBootOperation {
private final List<File> webInfProvidedLibs_ = new ArrayList<>();
/**
* Provides the destination file name that will be used for the archive creation.
* Provides the destination file name that will be used for the WAR creation.
*
* @param name the war archive destination file name
* @param name the wAR archive destination file name
* @return this operation instance
*/
@Override
@ -50,9 +50,9 @@ public class BootWarOperation extends AbstractBootOperation {
}
/**
* Provides the destination directory in which the archive will be created.
* Provides the destination directory in which the WAR will be created.
*
* @param directory the war destination directory
* @param directory the WAR destination directory
* @return this operation instance
*/
@Override
@ -61,7 +61,7 @@ public class BootWarOperation extends AbstractBootOperation {
}
/**
* Provides library JARs that will be used for the WAR creation.
* Provides JAR libraries that will be used for the WAR creation.
*
* @param jars Java archive files
* @return this operation instance
@ -72,7 +72,7 @@ public class BootWarOperation extends AbstractBootOperation {
}
/**
* Provides library JARs that will be used for the WAR creation.
* Provides JAR libraries that will be used for the WAR creation.
*
* @param jar Java archive file
* @return this operation instance
@ -224,7 +224,7 @@ public class BootWarOperation extends AbstractBootOperation {
/**
* Provides library JARs that will be used for the WAR creation in {@code /WEB-INF/lib-provided}.
* Provides JAR libraries that will be used for the WAR creation in {@code /WEB-INF/lib-provided}.
*
* @param jars Java archive files
* @return this operation instance
@ -235,7 +235,7 @@ public class BootWarOperation extends AbstractBootOperation {
}
/**
* Provides the library JARs that will be used for the WAR creation in {@code /WEB-INF/lib-provided}.
* Provides the JAR libraries that will be used for the WAR creation in {@code /WEB-INF/lib-provided}.
*
* @param jar Java archive file
* @return this operation instance