chaelgantman.MgntUtils.1.5.0.1.source-code.README.md Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of MgntUtils Show documentation

Set of various Utils: stacktrace noise filter, String to/from unicode sequence converter, simple Http client JSON parser/serializer, Silent String parsing to Integer and other numeric types, Parsing String to time intervals with support for time unit suffixes, JSON parser that provides serialization/deserialization of classes to JSON, Version comparator and Version ranges operations, Self-throttling binary reader from Http request, File reader, A utility that automatically initiates a Factory with instances of all classes that implement user provided interface. An infrastructure for writing Scheduled Task classes where time interval for task execution is provided in humanly readable format (such as "9h" for 9 hours)

There is a newer version: 1.7.0.1

Show newest version

# Mgnt
Mgnt Utilities
This utility package provides some convenience Utilities That provide some manipulations with several data types.
It introduces a new type "Version" as well as "VersionRange" and provides tools for version comparison, conversion from
and to String as well as work with Version ranges.

Probably the most interesting and useful feature is stacktrace extractor that allows to extract full or shortened
version of stacktrace. In particular it is very useful in J2EE environment. Exceptions on the server side usually
come with HUGE tail of application server related packages. That makes logs very verbose and hard to read and
search. TextUtils provides various getStacktrace methods that may drastically reduce such stacktraces in a very smart
way so all the important information is preserved. It sifts through "caused by" and "suppressed" parts of the stacktrace
as well.
Other features include parsing String into most of the implementations of Number interface without having
to catch NullPointerException of NumberFormatException. The methods take String value to parse, default value in case of
failure and messages (optional) that will be printed into log if some error occurred.
 
Another useful feature is parsing String to time interval. It parses Strings with numerical value and optional time unit
suffix (for example  string "38s" will be parsed as 38 seconds, "24m" - 24 minutes "4h" - 4 hours, "3d" - 3 days and "45"
as 45 milliseconds.) This method may be very useful for parsing time interval properties such as timeouts or waiting
periods from configuration files.


 Also there is a feature that converts String to preserve indentation formatting for html without use of escape
 characters. It converts a String in such a way that its spaces are not modified by HTML renderer i.e. it replaces
 regular space characters with non-breaking spaces known as '&nbsp;' but they look in your source as regular space
 '  ' and not as '&nbsp;' It also replaces new line character with '<br>'.


Another feature is some small infrastructure that simplifies and automates working with Factories that provide concrete 
implementations of an Interface. The package contains just 2 classes: BaseEntityFactory and BaseEntity. In short what 
this infrastructure does is that if you create a factory that extends BaseEntityFactory and some Interface with all its 
concrete implementations extending BaseEntity then each your concrete implementation class instances will be 
automatically inserted into your factory. You won't have to worry about how and when to populate your factory. 
The infrastructure will do it for you when the constructor of your concrete implementation class is invoked. So all you 
will have to do is to create any number of concrete implementation classes and make sure that for each one constructor 
is invoked. After that you can use your factory to get any of your concrete implementation classes anywhere in your code. 


An infrastructure that can run user implemented Task classes in a separate thread at configured 
time interval. The interval could be parsed from String in human readable format such as "9h" for 9 hours. This is based 
on use of the parsing String to time interval feature mentioned above 

Also class
StringUnicodeEncoderDecoder converts String into sequence of unicodes and vise-versa.
 Finally WebUtils class provides
a method for chunked reading of HttpRequest content. This could be useful when receiving large files from client on the
server side and the reading speed of the server is faster then writing speed of the client. The utility allows for
auto throttle to adjust to the client. This package was tested with Java versions 1.8 and 1.7 but probably would compile
and work with version as early as 5 and up. This library is available on Maven Central. Here are the artifacts:


        <dependency>

             <groupId>com.github.michaelgantman</groupId>

             <artifactId>MgntUtils</artifactId>

             <version>1.5.0.1</version>

        </dependency>


        <dependency>

             <groupId>com.github.michaelgantman</groupId>

             <artifactId>MgntUtils</artifactId>

             <version>1.5.0.1</version>

             <classifier>javadoc</classifier>

        </dependency>


        <dependency>

             <groupId>com.github.michaelgantman</groupId>

             <artifactId>MgntUtils</artifactId>

             <version>1.5.0.1</version>

             <classifier>sources</classifier>

        </dependency>



If have any feedback feel free to drop me a note at [email protected]