src-spring-framework/import-into-idea.md

The following has been tested against IntelliJ IDEA 2016.2.2

## Steps

_Within your locally cloned spring-framework working directory:_

1. Precompile `spring-oxm` with `./gradlew :spring-oxm:compileTestJava`
2. Import into IntelliJ (File -> New -> Project from Existing Sources -> Navigate to directory -> Select build.gradle)
3. When prompted exclude the `spring-aspects` module (or after the import via File-> Project Structure -> Modules)
4. Code away

## Known issues

1. `spring-core` and `spring-oxm` should be pre-compiled due to repackaged dependencies.
See `*RepackJar` tasks in the build and https://youtrack.jetbrains.com/issue/IDEA-160605).
2. `spring-aspects` does not compile due to references to aspect types unknown to
IntelliJ IDEA. See http://youtrack.jetbrains.com/issue/IDEA-64446 for details. In the meantime, the
'spring-aspects' can be excluded from the project to avoid compilation errors.
3. While JUnit tests pass from the command line with Gradle, some may fail when run from
IntelliJ IDEA. Resolving this is a work in progress. If attempting to run all JUnit tests from within
IntelliJ IDEA, you will likely need to set the following VM options to avoid out of memory errors:
    -XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=2048m
4. If you invoke "Rebuild Project" in the IDE, you'll have to generate some test
resources of the `spring-oxm` module again (`./gradlew :spring-oxm:compileTestJava`)    


## Tips

In any case, please do not check in your own generated .iml, .ipr, or .iws files.
You'll notice these files are already intentionally in .gitignore. The same policy goes for eclipse metadata.

## FAQ

Q. What about IntelliJ IDEA's own [Gradle support](http://confluence.jetbrains.net/display/IDEADEV/Gradle+integration)?

A. Keep an eye on http://youtrack.jetbrains.com/issue/IDEA-53476
Update for IntelliJ Idea 2016.2.2 Update tutorial for import and build project in IntelliJ IDEA 2016.2.2. Steps are outdated and existing issues is not applicable in new versions. 8 years ago			`The following has been tested against IntelliJ IDEA 2016.2.2`
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago
			`## Steps`

			`_Within your locally cloned spring-framework working directory:_`

Polish Issue: SPR-15592 8 years ago			1. Precompile `spring-oxm` with `./gradlew :spring-oxm:compileTestJava`
Polish import into IntelliJ instructions 8 years ago			`2. Import into IntelliJ (File -> New -> Project from Existing Sources -> Navigate to directory -> Select build.gradle)`
			3. When prompted exclude the `spring-aspects` module (or after the import via File-> Project Structure -> Modules)
Update import-into-idea.md Changes, according the latest information. 8 years ago			`4. Code away`
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago
Update import-into-idea.md Changes, according the latest information. 8 years ago			`## Known issues`
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago
Remove stray ` Remove stray ` in import-into-idea.md 8 years ago			1. `spring-core` and `spring-oxm` should be pre-compiled due to repackaged dependencies.
Polish import into IntelliJ instructions 8 years ago			See `*RepackJar` tasks in the build and https://youtrack.jetbrains.com/issue/IDEA-160605).
			2. `spring-aspects` does not compile due to references to aspect types unknown to
IDEA -> IntelliJ IDEA 8 years ago			`IntelliJ IDEA. See http://youtrack.jetbrains.com/issue/IDEA-64446 for details. In the meantime, the`
Polish import into IntelliJ instructions 8 years ago			`'spring-aspects' can be excluded from the project to avoid compilation errors.`
			`3. While JUnit tests pass from the command line with Gradle, some may fail when run from`
IDEA -> IntelliJ IDEA 8 years ago			`IntelliJ IDEA. Resolving this is a work in progress. If attempting to run all JUnit tests from within`
			`IntelliJ IDEA, you will likely need to set the following VM options to avoid out of memory errors:`
Various updates to support IDEA Remove the 'final' modifier from SingletonBeanFactoryLocatorTests to work around the "cannot extend final class" error issued when running all tests. The error was due to confusion with IDEA between the two variants of SingletonBeanFactoryLocatorTests across spring-context and spring-beans. Rename one of the GroovyMessenger classes to GroovyMessenger2. Previously there were multiple Groovy classes named 'GroovyMessenger', causing a compilation error in certain IDE arrangements. Update import-into-idea.md documentation Add various IDEA artifacts to .gitignore - ignore derby.log wherever it is written - ignore IDEA's test-output directory - ignore IDEA's Atlassian connector config file 12 years ago			`-XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=2048m`
Polish Issue: SPR-15592 8 years ago			`4. If you invoke "Rebuild Project" in the IDE, you'll have to generate some test`
			resources of the `spring-oxm` module again (`./gradlew :spring-oxm:compileTestJava`)
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago
Update for IntelliJ Idea 2016.2.2 Update tutorial for import and build project in IntelliJ IDEA 2016.2.2. Steps are outdated and existing issues is not applicable in new versions. 8 years ago
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago			`## Tips`

Various updates to support IDEA Remove the 'final' modifier from SingletonBeanFactoryLocatorTests to work around the "cannot extend final class" error issued when running all tests. The error was due to confusion with IDEA between the two variants of SingletonBeanFactoryLocatorTests across spring-context and spring-beans. Rename one of the GroovyMessenger classes to GroovyMessenger2. Previously there were multiple Groovy classes named 'GroovyMessenger', causing a compilation error in certain IDE arrangements. Update import-into-idea.md documentation Add various IDEA artifacts to .gitignore - ignore derby.log wherever it is written - ignore IDEA's test-output directory - ignore IDEA's Atlassian connector config file 12 years ago			`In any case, please do not check in your own generated .iml, .ipr, or .iws files.`
			`You'll notice these files are already intentionally in .gitignore. The same policy goes for eclipse metadata.`
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago
			`## FAQ`

IDEA -> IntelliJ IDEA 8 years ago			`Q. What about IntelliJ IDEA's own [Gradle support](http://confluence.jetbrains.net/display/IDEADEV/Gradle+integration)?`
Update README and add IDE import helper scripts - Update building from source section with Gradle instructions - Add import-into-eclipse.sh interactive helper script - Add import-into-idea.md with steps and known issues Note that use of STS Gradle tooling was attempted, but several issues remain before it can handle the spring-framework build. In the meantime the instructions laid out in import-into-eclipse provide an error-free import. 13 years ago
Various updates to support IDEA Remove the 'final' modifier from SingletonBeanFactoryLocatorTests to work around the "cannot extend final class" error issued when running all tests. The error was due to confusion with IDEA between the two variants of SingletonBeanFactoryLocatorTests across spring-context and spring-beans. Rename one of the GroovyMessenger classes to GroovyMessenger2. Previously there were multiple Groovy classes named 'GroovyMessenger', causing a compilation error in certain IDE arrangements. Update import-into-idea.md documentation Add various IDEA artifacts to .gitignore - ignore derby.log wherever it is written - ignore IDEA's test-output directory - ignore IDEA's Atlassian connector config file 12 years ago			`A. Keep an eye on http://youtrack.jetbrains.com/issue/IDEA-53476`