About

This project is to extend (Java/Groovy) core classes to improve productivity.

Usage

How to use it in your project:

Maven:

<dependency>
  <groupId>com.intellisrc</groupId>
  <artifactId>groovy-extend</artifactId>
  <version>VERSION</version>
</dependency>

Gradle:

dependecies {
    implementation 'com.intellisrc:groovy-extend:VERSION'
    // or extended annotation:
    implementation group: 'com.intellisrc', name: 'groovy-extend', version: 'VERSION'
}

In which VERSION is this package version, for example: 4.0.23.14. The first 3 numbers (4.0.23) are Groovy version used to compile this package. You can use the groovy version that fits your needs.

NOTE: Don't forget to add your groovy dependency.

Extensions

Date & Time

Date class should no longer be used. Because of that, we extended Date class to make it easier to change it to LocalDate and LocalDateTime:

Date Methods

• toLocalDateTime
• toLocalDate
• toLocalTime
• toZonedDateTime

LocalDate / LocalDateTime / LocalTime / ZonedDateTime Methods

• toDate : Only used for external codes which still rely on Date
• toDateTime : Convert to DateTime
• format : use DateTimeFormatter in an easy way
• isBetween : Check if date or time is between two other dates or times
• atStartOfDay : Added to LocalDate as well
• atEndOfDay : get the last nanosecond of the day

LocalDateTime / ZonedDateTime

• YMDHms : Return "yyyy-MM-dd HH:mm:ss"
• getYMDHms("","") : Return "yyyyMMddHHmmss"
• YMDHmsS : Return "yyyy-MM-dd HH:mm:ss.SSS"
• YMDHm : Return "yyyy-MM-dd HH:mm"
• toMillis : Return epoch milliseconds (long)
• fromMillis : (static) Convert epoch milliseconds into LocalDateTime
• toSeconds : Return epoch seconds (long)
• fromSeconds : (static) Convert epoch seconds into LocalDateTime

LocalDateTime only:

• clearTime : Return a LocalDateTime with 00:00:00.000 time

LocalDate / ZonedDateTime:

• YMD : Return "yyyy-MM-dd"

LocalDate only:

• YY : Return "yy"
• MM : Return "MM"
• DD : Return "dd"
• next() and previous() : Allows to use it as range: (from..to)

LocalTime only:

• HHmmss : Return "HH:mm:ss"
• getHHmmss("") : Return "HHmmss"
• HHmm : Return "HH:mm"

Files

These extensions provide faster ways to deal with files. Setting permissions and performing operations are made easier.

File Methods

Locating

• get : Similar to new File() but more flexible.
• create : Similar to get() but will create an empty file including their directories
• userDir : get User directory (root directory for project)
• homeDir : get Home directory
• tempDir : get the temporal directory

Performance

• lines : Get total lines in a file (faster way)
• eachFileAsync : Iterate through all files without having to read the whole directory first
• eachFileMatchAsync : Iterate files inside directory using glob search or FileFilter
• listFiles : Using glob search (Async) [@since 2.5.6.2]
• deleteFiles : Delete files using glob search or FileFilter (Async) [@since 2.5.6.2]

Permissions

• permissions : Will return PosixFilePermissions
• ownerPermissions : set owner permissions
• groupPermissions : set group permissions
• othersPermissions : set others permissions
• clearPermissions
• clearOwnerPermissions
• clearGroupPermissions
• clearOthersPermissions
• setReadable
• setWritable
• setExecutable
• setOwnerReadable
• setOwnerWritable
• setOwnerExecutable
• setGroupReadable
• setGroupWritable
• setGroupExecutable
• setOthersReadable
• setOthersWritable
• setOthersExecutable

Operations

• copyTo
• moveTo
• linkTo : Create a link from a file. Its argument is the link to create. An additional argument is to specify if link is hard or not.
• hardLinkOrCopyTo : Will try to create a hardLink, but if its in another device (which is not allowed), it will copy it.

String

Extends String methods that are commonly used and easiest ways to convert them.

• alphaNumeric : returns only alphanumeric characters
• padRight : pad to the right with spaces
• padLeft : pad to the left with spaces
• appendRandomNum : Useful to create random strings, e.g: 'apple1234'
• insertAt : Insert a substring into a string in a specific position

Conversion

• toInet4Address
• toInet6Address
• toInetAddress
• getQueryMap : Convert Query String to Map
• toDateTime : Convert String into LocalDateTime (auto detect format)
• toDate : Convert String into LocalDate (auto detect format)
• toTime : Convert String into LocalTime (auto detect format)
• toSnakeCase : Returns a string as snake_case_formatted_string
• toCamelCase : Returns a string as CamelCaseFormattedString
• toDotCase : Returns a string as dot.case.formatted.string
• toKebabCase : Returns a string as Kebab-Case-Formatted-String

BigDecimal

• ceil
• floor

Other

Map Methods

• toQueryString : Convert Map to Query String e.g : "a=1&b=2"

Random Methods

• range : Specify a range to get a random number

Collection Methods

• random : Get one or more random element from a collection (two implementations).

Additional Classes

• LimitedLinkedList : A list with a limited number of elements