xapi.util.api.Digester Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of xapi-gwt Show documentation

This module exists solely to package all other gwt modules into a single uber jar. This makes deploying to non-mavenized targets much easier. Of course, you would be wise to inherit your dependencies individually; the uber jar is intended for projects like collide, which have complex configuration, and adding many jars would be a pain.

The newest version!

/**
 *
 */
package xapi.util.api;

/**
 * A simple interface for creating digests of bytes; this is used primarily so we can have
 * shared code that is able to invoke Digest operations, without accessing any potentially
 * unsupported classes in a given environment.
 * 
 * This also allows the digest function to be easily pluggable, so end users can select the
 * digest algorithm to use.  The default implementation uses java core MD5 hashing.
 * 
 * This interface should be instantiated via X_Inject.instance(Digester.class),
 * as a digester needs to store internal state, it cannot be a singleton.
 *
 * @author James X. Nelson ([email protected], @james)
 *
 */
public interface Digester {

  Digester update(byte[] bytes, int offset, int length);

  byte[] digest();

  byte[] digest(byte[] bytes);

  String toString(byte[] bytes);
}