Speedment - Common - Invariant

Utility classes for making sure a methods invariant is met and otherwise throw exceptions.

License

License

Categories

Categories

Ant Build Tools Speedment Data Databases
GroupId

GroupId

com.speedment.common
ArtifactId

ArtifactId

invariant
Last Version

Last Version

3.2.10
Release Date

Release Date

Type

Type

jar
Description

Description

Speedment - Common - Invariant
Utility classes for making sure a methods invariant is met and otherwise throw exceptions.
Project URL

Project URL

https://www.github.com/speedment/speedment/wiki/Invariant/
Project Organization

Project Organization

Speedment, Inc.

Download invariant

How to add to project

<!-- https://jarcasting.com/artifacts/com.speedment.common/invariant/ -->
<dependency>
    <groupId>com.speedment.common</groupId>
    <artifactId>invariant</artifactId>
    <version>3.2.10</version>
</dependency>
// https://jarcasting.com/artifacts/com.speedment.common/invariant/
implementation 'com.speedment.common:invariant:3.2.10'
// https://jarcasting.com/artifacts/com.speedment.common/invariant/
implementation ("com.speedment.common:invariant:3.2.10")
'com.speedment.common:invariant:jar:3.2.10'
<dependency org="com.speedment.common" name="invariant" rev="3.2.10">
  <artifact name="invariant" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.speedment.common', module='invariant', version='3.2.10')
)
libraryDependencies += "com.speedment.common" % "invariant" % "3.2.10"
[com.speedment.common/invariant "3.2.10"]

Dependencies

test (5)

Group / Artifact Type Version
org.mockito : mockito-core jar 3.0.0
org.mockito : mockito-junit-jupiter jar 3.0.0
org.junit.jupiter : junit-jupiter-engine jar 5.5.2
org.junit.jupiter : junit-jupiter-api jar 5.5.2
org.junit.jupiter : junit-jupiter-params jar 5.5.2

Project Modules

There are no modules declared in this project.

Spire the Hare

Java Stream ORM

Maven Central Javadocs Build Status Hex.pm Join the chat at https://gitter.im/speedment/speedment

Speedment is an open source Java Stream ORM toolkit and runtime. The toolkit analyzes the metadata of an existing SQL database and automatically creates a Java representation of the data model. This powerful ORM enables you to create scalable and efficient Java applications using standard Java streams with no need to type SQL or use any new API.

Speedment was originally developed by researchers and engineers based in Palo Alto with the purpose to simplify and streamline the development of Java database applications by leveraging the Java Stream API.

Speedment is licensed under the business-friendly Apache 2 license. Contribution from users is encouraged. Please feel free to request new features, suggest improvements and file bug reports. Read more about contributing here.

Spire the Hare

Quick Start

Assuming you have Maven installed and a relational database available, you can start using Speedment in a minute:

Expressing SQL as Java Streams

There is a remarkable resemblance between Java streams and SQL as summarized in the simplified table. This means there is no need for manually writing SQL-queries any more. You can remain in a pure Java world!

Streams to SQL

Example

Search in a film database for a film with a length greater than 120 minutes:

// Searches are optimized in the background!
Optional<Film> longFilm = films.stream()
    .filter(Film.LENGTH.greaterThan(120))
    .findAny();

Results in the following SQL query:

SELECT 
    `film_id`,`title`,`description`,`release_year`,
    `language_id`,`original_language_id`,`rental_duration`,`rental_rate`,
    `length`,`replacement_cost`,`rating`,`special_features`,
    `last_update` 
FROM 
     `sakila`.`film
WHERE
    (`length` > 120)

Features

Speedment is equipped with the features listed below and more.

View Database Tables as Standard Java Streams

Stream API

  • Pure Java - Stream API instead of SQL eliminates the need of a query language
  • Dynamic Joins - Ability to perform joins as Java streams on the application side
  • Parallel Streams - Workload can automatically be divided over several threads

Short and Concise Type Safe Code

Type Safety

  • Code Generation - Automatic Java representation of the latest state of your database eliminates boilerplate code and the need of manually writing Java Entity classes while minimizing the risk for bugs.
  • Null Protection - Minimizes the risk involved with database null values by wrapping to Java Optionals
  • Enum Integration - Mapping of String columns to Java Enums increases memory efficiency and type safety

Lazy Evaluation

Lazy Evaluation for Increased Performance

  • Streams are Lazy - Content from the database is pulled as elements are needed and consumed
  • Pipeline Introspection - Optimized performance by short circuiting of stream operations

Tutorials

The tutorials are divided into three sections. The basics are covered in the first section without any expected prior knowledge of Speedment. This builds a foundation of knowledge needed to fully benefit from the following tutorials.

Basics

Sample applications

Extending Speedment

Resources

  • Documentation - Read the Speedment User Guide.
  • JavaDocs - Latest Speedment JavaDocs.
  • Examples - There are 15 detailed examples here and more can be found in the User Guide provided above.
  • Gitter Chatroom - Reach out to the Speedment developers and other community members via the Gitter chatroom.
  • Creating a Pull Request - Pull requests and improvement suggestions from the community are gladly accepted. Find more information here.

Requirements

Java Version

Speedment requires Java 8 or later. Make sure your IDE is configured to use JDK 8 (version 1.8.0_40 or newer).

Database Connectors

Speedment Open Source comes with support for the following databases out-of-the-box:

  • MySQL
  • MariaDB
  • PostgreSQL
  • SQLite

Enterprise database connectors include:

  • AS400
  • Cassandra
  • DB2
  • Informix
  • Oracle
  • Snowflake
  • SQL Server

For more information, see Speedment Licensing and Pricing.

Licenses

  • Speedment Open Source - This site covers the Speedment Open Source project available under the Apache 2 license.
  • Speedment Stream - The same great features as Speedment OSS with support for commercial databases. Learn more at speedment.com/stream.
  • Speedment HyperStream - An extension av Speedment Stream which also includes hypersonic query performance enabled by a unique in-JVM-memory management model. Learn more at speedment.com/hyperStream.

Copyright

Copyright (c) 2014-2019, Speedment, Inc. All Rights Reserved. Visit www.speedment.com for more info.

Analytics

Github activity visualized

com.speedment.common

Speedment

Speedment

Versions

Version
3.2.10
3.2.9
3.2.7
3.2.6
3.2.5
3.2.2
3.2.1
3.1.18
3.1.17
3.1.16
3.1.15
3.1.14
3.1.13
3.1.12
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0