# Jodd
**Repository Path**: pinna_angel/Jodd
## Basic Information
- **Project Name**: Jodd
- **Description**: Jodd 是一个开源的 Java 工具集， 包含一些实用的工具类和小型框架
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 35
- **Created**: 2018-01-31
- **Last Updated**: 2024-06-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
Jodd
Open-source Java micro-frameworks and tools; compact, yet powerful.
[](https://jodd.org)
[](https://travis-ci.org/oblac/jodd)
[](https://codecov.io/gh/oblac/jodd)
[](https://www.codacy.com/app/igo_rs/jodd)
[](https://bintray.com/oblac/jodd)
[](https://jitpack.io/#oblac/jodd)
[](https://stackoverflow.com/questions/tagged/jodd)
[](https://jodd.org/license.html)
[](https://twitter.com/intent/tweet?text=Hey,@joddorg%20is%20cool!&url=%5Bobject%20Object%5D)
[](https://www.codetriage.com/oblac/jodd)
+ Official web site (site & documentation): https://jodd.org
+ GitHub page (5 min overview): https://oblac.github.io/jodd
+ Jodd micro-frameworks (30 min overview): https://joddframework.org
+ One-page love: https://jodd.org/about
+ Talk with us at [gitter](https://gitter.im/oblac/jodd)!
Jodd = tools + ioc + mvc + db + aop + tx + json + html < 1.7 Mb
## :zap: Jodd Modules
**Jodd** is split into many modules, so choose what to use.
Some tools and utility modules are:
+ `jodd-core` contains many utilities, including `JDateTime`.
+ `jodd-bean`, our infamous `BeanUtil`, type inspectors and converters.
+ `jodd-props` is the super-replacement for Java `Properties`.
+ `jodd-mail` for easier email sending.
+ `jodd-upload`, handles HTTP uploads.
+ `jodd-servlet` with many servlet utilities, including nice tag library.
+ `jodd-http`, tiny HTTP client.
and some **micro-frameworks**:
+ `jodd-madvoc` - slick MVC framework.
+ `jodd-petite` - pragmatic DI container.
+ `jodd-lagarto` - HTML parser with `Jerry` and `CSSelly`.
+ `jodd-decora` - pages decorator.
+ `jodd-htmlstapler` - static page resources handler.
+ `jodd-proxetta` - dynamic proxies and `Paramo`.
+ `jodd-db` - thin database layer and object mapper.
+ `jodd-json` - JSON parser and serializer.
+ `jodd-vtor` - validation framework.
Read more in our [official documentation](http://jodd.org/doc).
## :sunny: Jodd Bundle
If you are already using many **Jodd** jars, you can simply
just use the _bundle_ jar: `jodd-all`. It's a single jar with
all modules included; where all dependencies are optional. Why not :)
## :octocat: Building Jodd from source
**Jodd** is built with [Gradle](http://gradle.org/) on JDK8,
targeting Java 1.8. You don't have to install anything,
the only prerequisites are [Git](http://help.github.com/set-up-git-redirect)
and Java JDK.
### Check out sources
Simply clone **Jodd** Git repo:
git clone https://github.com/oblac/jodd.git jodd
### Compile and test, build jars
You can build the Jodd project with:
gradlew build
This will build all jars and run all unit tests.
To skip the tests (for faster build), execute:
gradlew build -x test
### Build full release with reports
To generate _full release_, including running integration tests and generating various reports,
you need [Docker](https://www.docker.com/) v1.12+.
docker-compose -f etc/docker-compose.yml up
gradlew clean release
Integration tests requires some infrastructure (like databases), hence Docker is
used.
### Install Jodd into your local Maven
gradlew install
## :gift_heart: Contribute
Feel free to [contribute](CONTRIBUTING.md)! Follow these steps:
First time only:
+ fork the **Jodd** repo (`upstream`) to your GitHub account (`origin`)
+ clone `origin` as your `local` repo
+ install the [ZenHub](https://www.zenhub.com) plugin to track tasks
Every other time:
+ update both `origin` and `local` repos from `upstream`
+ create new branch for a feature or bug fix
+ commit often :)
+ once when work is done, push local changes to your `origin`
+ send us a pull request (PR)
We will pickup up from there :)
:rocket: