Go to file
Sam Brannen 07bb0378b9 Differentiate b/t (in)definite results in JsonPath assertions
Prior to this commit, the exists() method in JsonPathExpectationsHelper
correctly asserted that the evaluated JsonPath expression resulted in a
value (i.e., that a non-null value exists); however, if the value was
an empty array, the exists() method always threw an AssertionError.

The existing behavior makes sense if the JsonPath expression is
'indefinite' -- for example, if the expression uses a filter to select
results based on a predicate for which there is no match in the JSON
document, but the existing behavior is illogical and therefore invalid
if the JsonPath expression is 'definite' (i.e., directly references an
array in the JSON document that exists but happens to be empty). For
example, prior to this commit, the following threw an AssertionError.

    new JsonPathExpectationsHelper("$.arr").exists("{ 'arr': [] }");

Similar arguments can be made for the doesNotExist() method.

After thorough analysis of the status quo, it has become apparent that
the existing specialized treatment of arrays is a result of the fact
that the JsonPath library always returns an empty list if the path is
an 'indefinite' path that does not evaluate to a specific result.
Consult the discussion on "What is Returned When?" in the JsonPath
documentation for details:

    https://github.com/jayway/JsonPath#what-is-returned-when

This commit addresses these issues by ensuring that empty arrays are
considered existent if the JsonPath expression is definite but
nonexistent if the expression is indefinite.

Issue: SPR-13351
2015-08-14 22:07:03 +02:00
.settings/gradle
buildSrc/src/main Fix maven dependency scope conflicts in MergePlugin 2015-05-11 20:42:24 +02:00
gradle Upgrade to Gradle 2.5 2015-07-09 17:18:56 +03:00
spring-aop/src Fix default value of CommonsPool2TargetSource#maxWait 2015-08-14 16:34:32 +02:00
spring-aspects Polishing 2015-07-21 22:58:34 +02:00
spring-beans/src Polish tests 2015-08-12 19:35:45 +02:00
spring-beans-groovy/src/main Class identity comparisons wherever possible 2015-05-20 14:34:16 +02:00
spring-context Polish tests 2015-08-12 19:35:45 +02:00
spring-context-support/src JCacheEhCache3Tests enforces EhCache 3.0's CachingProvider 2015-08-12 23:09:16 +02:00
spring-core/src Polish tests 2015-08-12 19:35:45 +02:00
spring-expression Remove trailing whitespace in Java source code 2015-07-27 12:40:54 +02:00
spring-framework-bom
spring-instrument/src Harmonize log configuration 2014-03-20 09:43:29 -07:00
spring-instrument-tomcat/src TomcatInstrumentableClassLoader supports Tomcat 7.0.63+ as well 2015-07-15 00:02:55 +02:00
spring-jdbc/src Removal of redundant JdkVersion checks in the test suite 2015-08-12 18:42:36 +02:00
spring-jms/src Polishing 2015-07-29 01:08:16 +02:00
spring-messaging/src Introduce SmartMessageConverter interface with conversionHint arguments 2015-08-12 17:45:46 +02:00
spring-orm/src Clean up warnings on Hibernate support code 2015-07-21 23:39:07 +02:00
spring-orm-hibernate4/src Clean up warnings on Hibernate support code 2015-07-21 23:39:07 +02:00
spring-orm-hibernate5/src/main/java/org/springframework/orm/hibernate5 Clean up warnings on Hibernate support code 2015-07-21 23:39:07 +02:00
spring-oxm Completely remove JdkVersion check from Jaxb2Marshaller 2015-08-12 17:45:37 +02:00
spring-test Differentiate b/t (in)definite results in JsonPath assertions 2015-08-14 22:07:03 +02:00
spring-tx/src Add missing 4.2 XSDs 2015-08-01 09:50:36 +02:00
spring-web/src Overhaul CauchoRemotingTests & reinstate SimpleHessianServiceExporter test 2015-08-13 21:27:49 +02:00
spring-webmvc/src Ensure headers committed immediately for SseEmitter 2015-08-12 15:05:29 -04:00
spring-webmvc-portlet/src Introduce 'value' alias for 'attribute' in @AliasFor 2015-07-29 15:27:06 +02:00
spring-webmvc-tiles2/src Suppress warnings in tests 2014-12-31 02:10:30 +01:00
spring-websocket/src Ensure concurrent WebSocketSession wrapper is used 2015-08-13 08:00:24 -04:00
src Fix layout in What's New section 2015-08-11 23:48:15 +02:00
.gitignore
.mailmap Change gopivotal.com to pivotal.io 2014-10-05 18:12:50 +02:00
CONTRIBUTING-DOCUMENTATION.adoc
CONTRIBUTING.md Update links to Spring JIRA server 2014-03-10 12:26:29 +01:00
README.md Remove link to forums in README 2015-01-09 23:14:56 +01:00
build.gradle Upgrade to Objenesis 2.2 2015-08-12 19:54:43 +02:00
gradle.properties Next Development Version 2015-07-31 02:03:23 -07:00
gradlew
gradlew.bat
import-into-eclipse.bat
import-into-eclipse.sh Update Eclipse project import script 2014-12-13 14:24:01 +01:00
import-into-idea.md Update IDEA guidelines 2014-05-02 12:27:46 +02:00
settings.gradle Support for Hibernate ORM 5.0 Beta 2 2015-05-09 17:55:18 +02:00

README.md

Spring Framework

The Spring Framework provides a comprehensive programming and configuration model for modern Java-based enterprise applications -- on any kind of deployment platform. A key element of Spring is infrastructural support at the application level: Spring focuses on the "plumbing" of enterprise applications so that teams can focus on application-level business logic, without unnecessary ties to specific deployment environments.

The framework also serves as the foundation for Spring Integration, Spring Batch and the rest of the Spring family of projects. Browse the repositories under the Spring organization on GitHub for a full list.

Downloading Artifacts

See downloading Spring artifacts for Maven repository information. Unable to use Maven or other transitive dependency management tools? See building a distribution with dependencies.

Documentation

See the current Javadoc and reference docs.

Getting Support

Check out the spring tags on Stack Overflow. Commercial support is available too.

Issue Tracking

Report issues via the Spring Framework JIRA. Understand our issue management process by reading about the lifecycle of an issue. Think you've found a bug? Please consider submitting a reproduction project via the spring-framework-issues GitHub repository. The readme there provides simple step-by-step instructions.

Building from Source

The Spring Framework uses a Gradle-based build system. In the instructions below, ./gradlew is invoked from the root of the source tree and serves as a cross-platform, self-contained bootstrap mechanism for the build.

Prerequisites

Git and JDK 8 update 20 or later

Be sure that your JAVA_HOME environment variable points to the jdk1.8.0 folder extracted from the JDK download.

Check out sources

git clone git@github.com:spring-projects/spring-framework.git

Import sources into your IDE

Run ./import-into-eclipse.sh or read import-into-idea.md as appropriate.

Note: Per the prerequisites above, ensure that you have JDK 8 configured properly in your IDE.

Install all spring-* jars into your local Maven cache

./gradlew install

Compile and test; build all jars, distribution zips, and docs

./gradlew build

... and discover more commands with ./gradlew tasks. See also the Gradle build and release FAQ.

Contributing

Pull requests are welcome; see the contributor guidelines for details.

Staying in Touch

Follow @SpringCentral as well as @SpringFramework and its team members on Twitter. In-depth articles can be found at The Spring Blog, and releases are announced via our news feed.

License

The Spring Framework is released under version 2.0 of the Apache License.