Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sangupta/jerry

Common Java Functionality
https://github.com/sangupta/jerry

Last synced: 4 days ago
JSON representation

Common Java Functionality

Awesome Lists containing this project

README 

        
jerry

=====



`jerry` framework provides much of the common functionality that is used in a standard Java application like 

checking for application updates, providing template classes for CRUD operations with MongoDB, working with 

Quartz scheduler, and utility classes to work with HTML, cookies, JSON, XML, reflection, URIs, web and much 

more.



The project is built upon the following `jerry` module libraries:



* `jerry-core`: core functions and utility classes

* `jerry-http`: core helper classes to work with HTTP requests

* `jerry-web`: core helper classes when building Java web applications



Features

--------

* Collection of utility classes

* Powerful HTTP framework for handling web requests

* OAuth client and server side filters

* MongoDB abstract class for writing CRUD operations on objects with single line of code

* Quartz scheduling framework

* Basic security framework classes

* Basic batching framework

* Base62 encoder for 64-bit integers



Builds

------



**0.5.0**



* Refactoring project to divide project into various module libraries



**0.4.2-SNAPSHOT**



* Added ArchiveUtils - utility class to work with compressed files

* Added HttpServletResponseWrapper implementation that uses a ByteArray to buffer response

* Updated CookieUtils to add method to create a new Cookie

* Fixed bug in JavascriptTag to not include same Javascript URL twice



* Some minor refactorings and bug fixes

* Some libraries are back to `required` scope



**0.4.1**



* Added utility methods to ResponseUtils

* Fixed a bug in RequestCapturingFilter where chained filters were not being called

* Upgraded version on Apache Http-client library to 4.2.5

* Fixed bug where Cookie age was not being set correctly

* Added very fast Base64 encoder from another open-source project

* Fixed bug where not all data was being sent to HttpServletResponse due to encoding issues

* Added init() method to JerseyGrizzlyServer

* Some other smaller fixes



* All libraries were set to `provided` scope



**0.4.0**



* Added a Jersey-Grizzly based un/blocking server that can be used to run services from given packages

* Added `UnsafeMemory` class and corresponding interface to allow for serialization using `unsafe` direct memory for performance reasons

* Added a `WorkerGroup` convenience class to launch multiple worker threads via a given class/instance/runnable factory

* Added an interface `HttpStatusCode` that defines various HTTP status codes

* Added method to `EmailAddress` class to parse multiple email addresses from a given string supporting the format ` [email protected]`

* Added many constants to `DateUtils` class



Downloads

---------



The library can be downloaded from Maven Central using:



```xml



    com.sangupta

    jerry

    0.3.0



```



Dependencies

------------



`jerry` depends on the following frameworks directly



* Apache HTTP client for web access

* Apache Commons IO for disk I/O

* Jericho HTML parser to work with HTML



Besides these, `jerry` also uses the following libraries (as in Maven `provided` scope) to provide utility 

functions and extension classes to remove boiler-plate code.



* Hibernate framework

* Spring ORM framework

* Java MongoDB driver

* Spring Data MongoDB

* Google GSON library

* XStream XML parsing library



The difference in `direct` and `provided` dependency stems from the fact on usage. For example, you will only 

use `HibernateUtils` class when using Hibernate in your project, and thus we don't declare that as a direct 

dependency. This helps us keep the size of the `jerry` library small.



Continuous Integration

----------------------

The library is continuously integrated and unit tested using the *Travis CI system.



Current status of branch `MASTER`: [![Build Status](https://secure.travis-ci.org/sangupta/jerry.png?branch=master)](http://travis-ci.org/sangupta/jerry)



The library is tested against



* Oracle JDK 7

* Open JDK 7



Note: JDK6 has been removed from the list due to end-of-life from Oracle, and as support has been dropped by

http://travis-ci.org as well.



Versioning

----------



For transparency and insight into our release cycle, and for striving to maintain backward compatibility, 

`jerry` will be maintained under the Semantic Versioning guidelines as much as possible.



Releases will be numbered with the follow format:



`..`



And constructed with the following guidelines:



* Breaking backward compatibility bumps the major

* New additions without breaking backward compatibility bumps the minor

* Bug fixes and misc changes bump the patch



For more information on SemVer, please visit http://semver.org/.



License

-------

	

Copyright (c) 2012, Sandeep Gupta



The project uses various other libraries that are subject to their

own license terms. See the distribution libraries or the project

documentation for more details.



The entire source is licensed under the Apache License, Version 2.0 

(the "License"); you may not use this work except in compliance with

the LICENSE. You may obtain a copy of the License at



	http://www.apache.org/licenses/LICENSE-2.0



Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.