Libraries for Java 7+
Java Other
Clone or download

README.md

Libraries for Java 7+

(GitHub has a rendered version of this readme: https://github.com/stevewedig/blog/)

We all build up util code over time. In this project I'm sharing the most reusable parts of my codebase. As I publish features I'll be describing them on my blog and sharing the code via GitHub & Maven. I build on Google Guava, so you can think of these libraries as an extension of Guava, which itself is an extension of Java's standard library.

This project is compatable with Java 7+ and all code can be compiled to JavaScript by Google Web Toolkit 2.6+. The only runtime dependency is Guava.

Features

Features explained via blog posts

Utilities not explained via blog posts

These utilities should be fairly self explanatory...

Other related blog posts

Get code, run tests, create Javadocs

Use Git to get the project code:

cd <PROJECT_ROOT_PARENT>
git clone https://github.com/stevewedig/blog.git

Use Maven to run the tests:

cd <PROJECT_ROOT>
mvn test

Use Maven to generate the site, including the Javadocs:

cd <PROJECT_ROOT>
mvn site
# open site index: target/site/index.html
# or
# open javadoc index: target/site/project-reports.html

Javadocs for the latest release are also available at http://stevewedig.github.io/blog/apidocs/

Project organization

The root directory is a Maven project with the standard layout. The root directory is also a project for the Eclipse IDE. If you are using Eclipse, you can import the project under "Import > General > Existing Projects into Workspace". If you are not using Eclipse, you can disregard or delete the Eclipse project metadata files: .classpath, .project, .settings.

More about the standard layout of Maven projects.

Using the libraries

Maven dependency snippet

The easiest way to use this library is add it your dependency list in your Maven pom.xml file:

<dependencies>
    <dependency>
        <groupId>com.stevewedig</groupId>
        <artifactId>blog</artifactId>
        <version>2.0.2</version>
    </dependency>
</dependencies>

Other build tools

The Maven Central artifact page has snippets for other tools like Buildr, Ivy, and SBT.

Inheriting the GWT module

If you're using GWT, in addition to getting the code via Maven or other mechanism, add this line to your .gwt.xml file:

<inherits name="com.stevewedig.blog.Blog" />