blog

KO | EN

gitlite — search

#javascript #hacktoberfest #react #golang #android #linux #macos #java #windows #awesome #cli #awesome-list #pytorch #open-source

(★ 16)

Libraries for Java 7+

blog Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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](http://stevewedig.com) and sharing the code via GitHub & Maven. I build on [Google Guava](https://code.google.com/p/guava-libraries/), 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](http://en.wikipedia.org/wiki/Google_Web_Toolkit) 2.6+. The only runtime dependency is Guava.

* **Javadocs**: [http://stevewedig.github.io/blog/apidocs/](http://stevewedig.github.io/blog/apidocs/)
* **GitHub Repo**: [https://github.com/stevewedig/blog](https://github.com/stevewedig/blog)
* **License**: This project is in the public domain via [Unlicense](http://unlicense.org).

## Features

#### Features explained via blog posts

* [Value Objects in Java & Python](http://stevewedig.com/2014/07/31/value-objects-in-java-and-python/)
* [Type Safe Heterogenous Containers in Java](http://stevewedig.com/2014/08/28/type-safe-heterogenous-containers-in-java/)
* [Digraphs, Dags, and Trees in Java](http://stevewedig.com/2014/10/06/digraphs-dags-and-trees-in-java/)

#### Utilities not explained via blog posts

These utilities should be fairly self explanatory...

* [StrLib](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/util/StrLib.java) demonstrated in [TestStrLib](https://github.com/stevewedig/blog/tree/master/src/test/java/com/stevewedig/blog/util/TestStrLib.java): String manipulation utilities. (Behavior not found in Guava's [Strings](https://code.google.com/p/guava-libraries/wiki/StringsExplained) or Apache Commons [StringUtils](http://commons.apache.org/proper/commons-lang/javadocs/api-release/org/apache/commons/lang3/StringUtils.html).)
* [LambdaLib](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/util/LambdaLib.java) demonstrated in [TestLambdaLib](https://github.com/stevewedig/blog/tree/master/src/test/java/com/stevewedig/blog/util/TestLambdaLib.java): Interfaces for creating anonymous lambdas (callbacks). Presumably I can get rid of this horrible syntax when I switch to Java 8.
* [CollectLib](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/util/CollectLib.java) demonstrated in [TestCollectLib](https://github.com/stevewedig/blog/tree/master/src/test/java/com/stevewedig/blog/util/TestCollectLib.java)
* [SetLib](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/util/SetLib.java) demonstrated in [TestSetLib](https://github.com/stevewedig/blog/tree/master/src/test/java/com/stevewedig/blog/util/TestSetLib.java)
* [MultimapLib](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/util/MultimapLib.java) demonstrated in [TestMultimapLib](https://github.com/stevewedig/blog/tree/master/src/test/java/com/stevewedig/blog/util/TestMultimapLib.java)
* [blog.errors](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/errors): A collection of common errors, and an [ErrorMixin](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/errors/ErrorMixin.java) which adds string formatting constructors to RuntimeException.

#### Other related blog posts

* [A Software Developer's Reading List](http://stevewedig.com/2014/02/03/software-developers-reading-list/)
* [Why & How I Write Java](http://stevewedig.com/2014/02/17/why-and-how-i-write-java/)

## Get code, run tests, create Javadocs

Use [Git](http://en.wikipedia.org/wiki/Git_(software)) to get the project code:

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

Use [Maven](http://en.wikipedia.org/wiki/Apache_Maven) to run the tests:
    
    cd <PROJECT_ROOT>
    mvn test

Use [Maven](http://en.wikipedia.org/wiki/Apache_Maven) to generate the site, including the [Javadocs](http://en.wikipedia.org/wiki/Javadoc):

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/](http://stevewedig.github.io/blog/apidocs/)

## Project organization

The root directory is a Maven project with the [standard layout](https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html). The root directory is also a project for the [Eclipse IDE](http://en.wikipedia.org/wiki/Eclipse_(software)). 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.

* **Library code**: [src/main/java/com/stevewedig/blog/](https://github.com/stevewedig/blog/tree/master/src/main/java/com/stevewedig/blog/)
* **Test code**: [src/test/java/com/stevewedig/blog/](https://github.com/stevewedig/blog/tree/master/src/test/java/com/stevewedig/blog)
* **Directory built by Maven**: target/
* **Project's site root**: target/site/index.html (Javadocs are linked to under "Project Reports")
* **Project's Javadoc root**: target/site/apidocs/index.html

More about the [standard layout of Maven projects](https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html).

## Using the libraries

#### Maven dependency snippet

The easiest way to use this library is add it your dependency list in your Maven [pom.xml](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html) 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](http://search.maven.org/#artifactdetails%7Ccom.stevewedig%7Cblog%7C2.0.2%7Cjar) 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:

blog

blog Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

blog

blog Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README