Skip to content

Commit 14f7c6c

Browse files
committed
U some javadoc comments to reduce warnings when deploying to repo
1 parent 5b067ed commit 14f7c6c

File tree

1 file changed

+194
-0
lines changed

1 file changed

+194
-0
lines changed

src/main/java/io/github/fvarrui/javapackager/packagers/PackagerSettings.java

Lines changed: 194 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -452,197 +452,391 @@ public PackagerSettings generateInstaller(Boolean generateInstaller) {
452452
return this;
453453
}
454454

455+
/**
456+
* Set main class
457+
* @param mainClass Main class
458+
* @return Packager settings
459+
*/
455460
public PackagerSettings mainClass(String mainClass) {
456461
this.mainClass = mainClass;
457462
return this;
458463
}
459464

465+
/**
466+
* Set name
467+
* @param name Name
468+
* @return Packager settings
469+
*/
460470
public PackagerSettings name(String name) {
461471
this.name = name;
462472
return this;
463473
}
464474

475+
/**
476+
* Set display name
477+
* @param displayName Display name
478+
* @return Packager settings
479+
*/
465480
public PackagerSettings displayName(String displayName) {
466481
this.displayName = displayName;
467482
return this;
468483
}
469484

485+
/**
486+
* Set version
487+
* @param version Version
488+
* @return Packager settings
489+
*/
470490
public PackagerSettings version(String version) {
471491
this.version = version;
472492
return this;
473493
}
474494

495+
/**
496+
* Set description
497+
* @param description Description
498+
* @return Packager settings
499+
*/
475500
public PackagerSettings description(String description) {
476501
this.description = description;
477502
return this;
478503
}
479504

505+
/**
506+
* Set URL
507+
* @param url URL
508+
* @return Packager settings
509+
*/
480510
public PackagerSettings url(String url) {
481511
this.url = url;
482512
return this;
483513
}
484514

515+
/**
516+
* Set administrator required
517+
* @param administratorRequired Administrator required
518+
* @return Packager settings
519+
*/
485520
public PackagerSettings administratorRequired(Boolean administratorRequired) {
486521
this.administratorRequired = administratorRequired;
487522
return this;
488523
}
489524

525+
/**
526+
* Set organizstion name
527+
* @param organizationName Organization name
528+
* @return Packager settings
529+
*/
490530
public PackagerSettings organizationName(String organizationName) {
491531
this.organizationName = organizationName;
492532
return this;
493533
}
494534

535+
/**
536+
* Set organization URL
537+
* @param organizationUrl Organization URL
538+
* @return Packager settings
539+
*/
495540
public PackagerSettings organizationUrl(String organizationUrl) {
496541
this.organizationUrl = organizationUrl;
497542
return this;
498543
}
499544

545+
/**
546+
* Set organization email
547+
* @param organizationEmail
548+
* @return Packager settings
549+
*/
500550
public PackagerSettings organizationEmail(String organizationEmail) {
501551
this.organizationEmail = organizationEmail;
502552
return this;
503553
}
504554

555+
/**
556+
* Set bundle JRE
557+
* @param bundleJre Bundle JRE
558+
* @return Packager settings
559+
*/
505560
public PackagerSettings bundleJre(Boolean bundleJre) {
506561
this.bundleJre = bundleJre;
507562
return this;
508563
}
509564

565+
/**
566+
* Set customized JRE
567+
* @param customizedJre Customized JRE
568+
* @return Packager settings
569+
*/
510570
public PackagerSettings customizedJre(Boolean customizedJre) {
511571
this.customizedJre = customizedJre;
512572
return this;
513573
}
514574

575+
/**
576+
* Set JRE path
577+
* @param jrePath JRE path
578+
* @return Packager settings
579+
*/
515580
public PackagerSettings jrePath(File jrePath) {
516581
this.jrePath = jrePath;
517582
return this;
518583
}
519584

585+
/**
586+
* Set JDK path
587+
* @param jdkPath JDK path
588+
* @return Packager settings
589+
*/
520590
public PackagerSettings jdkPath(File jdkPath) {
521591
this.jdkPath = jdkPath;
522592
return this;
523593
}
524594

595+
/**
596+
* Set additional resources list
597+
* @param additionalResources Additional resources list
598+
* @return Packager settings
599+
*/
525600
public PackagerSettings additionalResources(List<File> additionalResources) {
526601
this.additionalResources = new ArrayList<>(additionalResources);
527602
return this;
528603
}
529604

605+
/**
606+
* Set modules list
607+
* @param modules Modules list
608+
* @return Packager settings
609+
*/
530610
public PackagerSettings modules(List<String> modules) {
531611
this.modules = new ArrayList<>(modules);
532612
return this;
533613
}
534614

615+
/**
616+
* Set additional modules list
617+
* @param additionalModules Additional modules list
618+
* @return Packager settings
619+
*/
535620
public PackagerSettings additionalModules(List<String> additionalModules) {
536621
this.additionalModules = new ArrayList<>(additionalModules);
537622
return this;
538623
}
539624

625+
/**
626+
* Set platform
627+
* @param platform Platform
628+
* @return Packager settings
629+
*/
540630
public PackagerSettings platform(Platform platform) {
541631
this.platform = platform;
542632
return this;
543633
}
544634

635+
/**
636+
* Set ENV path
637+
* @param envPath ENV path
638+
* @return Packager settings
639+
*/
545640
public PackagerSettings envPath(String envPath) {
546641
this.envPath = envPath;
547642
return this;
548643
}
549644

645+
/**
646+
* Set VM arguments
647+
* @param vmArgs VM arguments
648+
* @return Packager settings
649+
*/
550650
public PackagerSettings vmArgs(List<String> vmArgs) {
551651
this.vmArgs = new ArrayList<>(vmArgs);
552652
return this;
553653
}
554654

655+
/**
656+
* Set runnable JAR
657+
* @param runnableJar Runnable JAR
658+
* @return Packager settings
659+
*/
555660
public PackagerSettings runnableJar(File runnableJar) {
556661
this.runnableJar = runnableJar;
557662
return this;
558663
}
559664

665+
/**
666+
* Set copy dependencies
667+
* @param copyDependencies Copy dependencies
668+
* @return Packager settings
669+
*/
560670
public PackagerSettings copyDependencies(Boolean copyDependencies) {
561671
this.copyDependencies = copyDependencies;
562672
return this;
563673
}
564674

675+
/**
676+
* Set JRE directory name
677+
* @param jreDirectoryName JRE directory name
678+
* @return Packager settings
679+
*/
565680
public PackagerSettings jreDirectoryName(String jreDirectoryName) {
566681
this.jreDirectoryName = jreDirectoryName;
567682
return this;
568683
}
569684

685+
/**
686+
* Set Windows specific configuration
687+
* @param winConfig Windows specific configuration
688+
* @return Packager settings
689+
*/
570690
public PackagerSettings winConfig(WindowsConfig winConfig) {
571691
this.winConfig = winConfig;
572692
return this;
573693
}
574694

695+
/**
696+
* Set GNU/Linux specific configuration
697+
* @param linuxConfig GNU/Linux specific configuration
698+
* @return Packager settings
699+
*/
575700
public PackagerSettings linuxConfig(LinuxConfig linuxConfig) {
576701
this.linuxConfig = linuxConfig;
577702
return this;
578703
}
579704

705+
/**
706+
* Set Mac OS specific configuration
707+
* @param macConfig Mac OS specific configuration
708+
* @return Packager settings
709+
*/
580710
public PackagerSettings macConfig(MacConfig macConfig) {
581711
this.macConfig = macConfig;
582712
return this;
583713
}
584714

715+
/**
716+
* Set create tarball
717+
* @param createTarball Create tarball
718+
* @return Packager settings
719+
*/
585720
public PackagerSettings createTarball(Boolean createTarball) {
586721
this.createTarball = createTarball;
587722
return this;
588723
}
589724

725+
/**
726+
* Set create zipball
727+
* @param createZipball Create zipball
728+
* @return Packager settings
729+
*/
590730
public PackagerSettings createZipball(Boolean createZipball) {
591731
this.createZipball = createZipball;
592732
return this;
593733
}
594734

735+
/**
736+
* Set extra parameters map
737+
* @param extra Extra parameters map
738+
* @return Packager settings
739+
*/
595740
public PackagerSettings extra(Map<String, String> extra) {
596741
this.extra = extra;
597742
return this;
598743
}
599744

745+
/**
746+
* Set if it use resources folder as working directory
747+
* @param useResourcesAsWorkingDir Use resources folder as working directory
748+
* @return Packager settings
749+
*/
600750
public PackagerSettings useResourcesAsWorkingDir(boolean useResourcesAsWorkingDir) {
601751
this.useResourcesAsWorkingDir = useResourcesAsWorkingDir;
602752
return this;
603753
}
604754

755+
/**
756+
* Set asstes directory
757+
* @param assetsDir Assets directory
758+
* @return Packager settings
759+
*/
605760
public PackagerSettings assetsDir(File assetsDir) {
606761
this.assetsDir = assetsDir;
607762
return this;
608763
}
609764

765+
/**
766+
* Set classpath
767+
* @param classpath Classpath
768+
* @return Packager settings
769+
*/
610770
public PackagerSettings classpath(String classpath) {
611771
this.classpath = classpath;
612772
return this;
613773
}
614774

775+
/**
776+
* Set minimal JRE version
777+
* @param jreMinVersion JRE minimal version
778+
* @return Packager settings
779+
*/
615780
public PackagerSettings jreMinVersion(String jreMinVersion) {
616781
this.jreMinVersion = jreMinVersion;
617782
return this;
618783
}
619784

785+
/**
786+
* Set Manifest configuration
787+
* @param manifest Manifest
788+
* @return Packager settings
789+
*/
620790
public PackagerSettings manifest(Manifest manifest) {
621791
this.manifest = manifest;
622792
return this;
623793
}
624794

795+
/**
796+
* Set additional module paths
797+
* @param additionalModulePaths Additional module path list
798+
* @return Packager settings
799+
*/
625800
public PackagerSettings additionalModulePaths(List<File> additionalModulePaths) {
626801
this.additionalModulePaths = additionalModulePaths;
627802
return this;
628803
}
629804

805+
/**
806+
* Set file associations
807+
* @param fileAssociations File associations list
808+
* @return Packager settings
809+
*/
630810
public PackagerSettings fileAssociations(List<FileAssociation> fileAssociations) {
631811
this.fileAssociations = fileAssociations;
632812
return this;
633813
}
634814

815+
/**
816+
* Set scripts
817+
* @param scripts Scripts
818+
* @return Packager settings
819+
*/
635820
public PackagerSettings scripts(Scripts scripts) {
636821
this.scripts = scripts;
637822
return this;
638823
}
639824

640825
// some helpful methods
641826

827+
/**
828+
* Checks if there are file associations specified
829+
* @return true if there are file asociations, otherwise false
830+
*/
642831
public boolean isThereFileAssociations() {
643832
return fileAssociations != null && !fileAssociations.isEmpty();
644833
}
645834

835+
/**
836+
* Mime types list to string
837+
* @param separator Character used to join mime types into one string
838+
* @return Mime type list string
839+
*/
646840
public String getMimeTypesListAsString(String separator) {
647841
return StringUtils.join(fileAssociations.stream().map(fa -> fa.getMimeType()).collect(Collectors.toList()),
648842
separator);

0 commit comments

Comments
 (0)