17128311f4
This commit updates URLs to prefer the https protocol. Redirects are not followed to avoid accidentally expanding intentionally shortened URLs (i.e. if using a URL shortener). # HTTP URLs that Could Not Be Fixed These URLs were unable to be fixed. Please review them to see if they can be manually resolved. * [ ] http://www.mybatis.org/mybatis-3/logging.html (200) with 1 occurrences could not be migrated: ([https](https://www.mybatis.org/mybatis-3/logging.html) result SSLHandshakeException). # Fixed URLs ## Fixed Success These URLs were switched to an https URL with a 2xx status. While the status was successful, your review is still recommended. * [ ] http://en.wikipedia.org/wiki/Dependency_Injection with 2 occurrences migrated to: https://en.wikipedia.org/wiki/Dependency_Injection ([https](https://en.wikipedia.org/wiki/Dependency_Injection) result 200). * [ ] http://github.com/spring-projects/spring-data-jdbc with 1 occurrences migrated to: https://github.com/spring-projects/spring-data-jdbc ([https](https://github.com/spring-projects/spring-data-jdbc) result 200). * [ ] http://spring.io/blog with 2 occurrences migrated to: https://spring.io/blog ([https](https://spring.io/blog) result 200). * [ ] http://stackoverflow.com/questions/tagged/spring-data-jdbc with 2 occurrences migrated to: https://stackoverflow.com/questions/tagged/spring-data-jdbc ([https](https://stackoverflow.com/questions/tagged/spring-data-jdbc) result 200). * [ ] http://contributor-covenant.org with 1 occurrences migrated to: https://contributor-covenant.org ([https](https://contributor-covenant.org) result 301). * [ ] http://contributor-covenant.org/version/1/3/0/ with 1 occurrences migrated to: https://contributor-covenant.org/version/1/3/0/ ([https](https://contributor-covenant.org/version/1/3/0/) result 301). * [ ] http://docs.spring.io/spring-data/data-commons/docs/current/api/index.html?org/springframework/data/domain/Persistable.html with 1 occurrences migrated to: https://docs.spring.io/spring-data/data-commons/docs/current/api/index.html?org/springframework/data/domain/Persistable.html ([https](https://docs.spring.io/spring-data/data-commons/docs/current/api/index.html?org/springframework/data/domain/Persistable.html) result 301). * [ ] http://docs.spring.io/spring-framework/docs/ with 1 occurrences migrated to: https://docs.spring.io/spring-framework/docs/ ([https](https://docs.spring.io/spring-framework/docs/) result 301). * [ ] http://help.github.com/forking/ with 2 occurrences migrated to: https://help.github.com/forking/ ([https](https://help.github.com/forking/) result 301). * [ ] http://projects.spring.io/spring-data with 2 occurrences migrated to: https://projects.spring.io/spring-data ([https](https://projects.spring.io/spring-data) result 301). * [ ] http://projects.spring.io/spring-framework with 2 occurrences migrated to: https://projects.spring.io/spring-framework ([https](https://projects.spring.io/spring-framework) result 301). * [ ] http://www.springsource.org/download with 1 occurrences migrated to: https://www.springsource.org/download ([https](https://www.springsource.org/download) result 302). Original Pull Request: #133
93 lines
4.6 KiB
Plaintext
93 lines
4.6 KiB
Plaintext
image:https://spring.io/badges/spring-data-jdbc/ga.svg["Spring Data JDBC", link="https://spring.io/projects/spring-data-jdbc#learn"]
|
||
image:https://spring.io/badges/spring-data-jdbc/snapshot.svg["Spring Data JDBC", link="https://spring.io/projects/spring-data-jdbc#learn"]
|
||
|
||
= Spring Data JDBC
|
||
|
||
The primary goal of the https://projects.spring.io/spring-data[Spring Data] project is to make it easier to build Spring-powered applications that use data access technologies. *Spring Data JDBC* offers the popular Repository abstraction based on JDBC.
|
||
|
||
It aims at being conceptually easy.
|
||
In order to achieve this it does NOT offer caching, lazy loading, write behind or many other features of JPA.
|
||
This makes Spring Data JDBC a simple, limited, opinionated ORM.
|
||
|
||
== Features
|
||
|
||
* Implementation of CRUD methods for Aggregates.
|
||
* `@Query` annotation
|
||
* Support for transparent auditing (created, last changed)
|
||
* Events for persistence events
|
||
* Possibility to integrate custom repository code
|
||
* JavaConfig based repository configuration by introducing `EnableJdbcRepository`
|
||
* Integration with MyBatis
|
||
|
||
== Getting Help
|
||
|
||
If you are new to Spring Data JDBC read the following two articles https://spring.io/blog/2018/09/17/introducing-spring-data-jdbc["Introducing Spring Data JDBC"] and https://spring.io/blog/2018/09/24/spring-data-jdbc-references-and-aggregates["Spring Data JDBC, References, and Aggregates"]
|
||
|
||
There are also examples in the https://github.com/spring-projects/spring-data-examples/tree/master/jdbc[Spring Data Examples] project.
|
||
|
||
A very good source of information is the source code in this repository.
|
||
Especially the integration tests (if you are reading this on github, type `t` and then `IntegrationTests.java`)
|
||
|
||
We are keeping an eye on the (soon to be created) https://stackoverflow.com/questions/tagged/spring-data-jdbc[spring-data-jdbc tag on stackoverflow].
|
||
|
||
If you think you found a bug, or have a feature request please https://jira.spring.io/browse/DATAJDBC/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel[create a ticket in our issue tracker].
|
||
|
||
== Execute Tests
|
||
|
||
=== Fast running tests
|
||
|
||
Fast running tests can be executed with a simple
|
||
|
||
[source]
|
||
----
|
||
mvn test
|
||
----
|
||
|
||
This will execute unit tests and integration tests using an in-memory database.
|
||
|
||
=== Running tests with a real database
|
||
|
||
In order to run the integration tests against a specific database you need to have a local Docker installation available, and then execute.
|
||
|
||
[source]
|
||
----
|
||
mvn test -Dspring.profiles.active=<databasetype>
|
||
----
|
||
|
||
This will also execute the unit tests.
|
||
|
||
Currently the following _databasetypes_ are available:
|
||
|
||
* hsql (default, does not require a running database)
|
||
* mysql
|
||
* postgres
|
||
* mariadb
|
||
* mssql
|
||
|
||
Testing with Microsoft SQL Server requires you to accept the EULA of the Microsoft SQL Server Docker image, so the build may download and run it for you.
|
||
In order to accept the EULA please add a file named `container-license-acceptance.txt` to the classpath, i.e. `src/test/resources` with the content:
|
||
|
||
```
|
||
microsoft/mssql-server-linux:2017-CU6
|
||
```
|
||
|
||
=== Run tests with all databases
|
||
|
||
[source]
|
||
----
|
||
mvn test -Pall-dbs
|
||
----
|
||
|
||
This will execute the unit tests, and all the integration tests with all the databases we currently support for testing. Running the integration-tests depends on Docker.
|
||
|
||
== Contributing to Spring Data JDBC
|
||
|
||
Here are some ways for you to get involved in the community:
|
||
|
||
* Get involved with the Spring community by helping out on https://stackoverflow.com/questions/tagged/spring-data-jdbc[stackoverflow] by responding to questions and joining the debate.
|
||
* Create https://jira.spring.io/browse/DATAJDBC[JIRA] tickets for bugs and new features and comment and vote on the ones that you are interested in.
|
||
* Github is for social coding: if you want to write code, we encourage contributions through pull requests from https://help.github.com/forking/[forks of this repository]. If you want to contribute code this way, please reference a JIRA ticket as well, covering the specific issue you are addressing.
|
||
* Watch for upcoming articles on Spring by https://spring.io/blog[subscribing] to spring.io.
|
||
|
||
Before we accept a non-trivial patch or pull request we will need you to https://cla.pivotal.io/sign/spring[sign the Contributor License Agreement]. Signing the contributor’s agreement does not grant anyone commit rights to the main repository, but it does mean that we can accept your contributions, and you will get an author credit if we do. If you forget to do so, you'll be reminded when you submit a pull request. Active contributors might be asked to join the core team, and given the ability to merge pull requests.
|