This page is for Grouper developers.

Note the coding standards: Grouper developers coding standards

General tips

You should be using Eclipse, but you can also use the IDE of your choice
- You should have webtools with tomcat 8.5
For profiling we use YourKit
- YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications.
- YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, YourKit YouMonitor
Checkout the git repo for GROUPER_2_5_BRANCH (main)
Install mysql (or whatever database you want, probably better to not use hsql, though you could)
Dbeaver
- Make sure to set to not do uppercase (doesnt work on mysql linux)
You can use as a maven project, or ant project
Do an ant build
Configure the grouper-hibernate.properties for database
Do a gsh -registry -runscript
Start GSH and run some commands
Have the UI include a source folder from the API for source and conf
Add a tomcat to eclipse
Do an "ant dev" in the UI to get the libs in WEB-INF/lib
Download the required tomcat version (e.g. tomcat 8.5)
Make sure API has all libs exported
ui and ws (and others) have a project dependency on grouper)
Map the webapp dir to tomcat, UI should start
Add tomcat users for GrouperSystem and test.subject.0, set your password
Do an "ant dev" in the WS to get the libs in WEB-INF/lib

Map the webapp dir to tomcat, WS should start, try a call from the client

Eclipse setup

Project setup

TODO

Checkstyle plugin

Grouper uses Checkstyle configuration files to scan for general style issues in source code. These are in the grouper-parent/src/checkstyle project directory, and can be used to set up IDE background checking on Java files.

Go to Help→Eclipse Marketplace, and install "Checkstyle Plugin (eclipse-cs)". Click OK if needed to install unsigned content

Grouper Internal Development > Grouper development environment > Screen Shot 2020-01-11 at 12.57.29 PM.png

Configure via File→ Properties→ Checkstyle→ Local Check Configurations

Grouper Internal Development > Grouper development environment > image2019-11-6_23-43-43.png

Click New... to create the local configuration. Choose Type "Project Relative Configuration". The location of the file will be under /grouper-parent/src/checkstyle. File checkstyle-legacy.xml just has a few checks and is geared toward older code with more issues, while checkstyle.xml has more checks and is better for newer files.

Grouper Internal Development > Grouper development environment > image2019-11-6_23-44-45.png

On the main tab, check "Checkstyle active for this project", choose the newly created configuration. To adjust the number of warnings, you can check more boxes under the "Exclude from checking" choices.

Grouper Internal Development > Grouper development environment > image2019-11-6_23-49-23.png

Sample output:

Grouper Internal Development > Grouper development environment > image2019-11-7_0-3-19.png

IntelliJ IDEA setup

Project setup

Projects -> Open

{GIT}/grouper/grouper-parent/pom.xml -> Open as Project

Wait a few minutes (6+) while it downloads dependencies and structures the subprojects

When it's finished, you should see a folder in bold for all the subprojects associated with the release

Grouper Internal Development > Grouper development environment > Screenshot from 2022-08-31 14-33-40.png

Checkstyle plugin

Install the plugin: File -> Settings -> Plugins -> CheckStyle IDEA

Restart the IDE as directed

File -> Settings -> Tools -> Checkstyle

Add configuration file:

Name: Grouper checkstyle
Location: {GIT}/grouper-parent/src/checkstyle/checkstyle.xml

Add configuration file:

Name: Grouper checkstyle - legacy
Location: {GIT}/grouper-parent/src/checkstyle/checkstyle-legacy.xml

Choose checkstyle version 8.23 (the Grouper checkstyle.xml is not compatible with higher versions)

When you create a new Java class, there is a Checkstyle docked tab. You can scan your class (use the Grouper checkstyle and not the legacy one) before committing to make sure standards have been met.

Coding defaults

Editor -> Code style:
- Scheme: Project
- Line separator: \n (applies to new files)
- Hard wrap: 200 characters
- Visual guides: 120, 200
- Java:
  - Tabs and indents:
    - Tab size: 2
    - Indent: 2
    - Continuation indent: 8
    - (Off) Keep indents on empty lines (actual use of indented blank lines in Grouper is about 50/50)
  - Imports:
    - Class count to use import with '*': 999 (i.e., never collapse imports)
    - Names count to use import with '*': 999 (i.e., never collapse imports)
Editor -> File and Code Templates:
- Scheme: Project
- For Class, Interface, and Enum, move #parse("File Header.java") from the second to the first line
- Includes -> File Header (should already be defined), paste this

/****
* Copyright 2022 Internet2
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
***/

Miscellaneous

Patch java example

This is not really Grouper specific, but if you want to patch a jar in a webapp, here is an example:

 cd /tmp
 mkdir grouper
 cd grouper
 mkdir src
 cd src
 unzip /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/grouper.jar
 ### note, might want to delete all other source and class files except the one you need ###
 emacs edu/internet2/middleware/grouper/app/loader/GrouperLoaderType.java

 javac -cp .:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/subject.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/commons-lang.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/log4j.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/hibernate.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/commons-logging.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/DdlUtils.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/quartz.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/commons-collections.jar:/opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/lib/grouper.jar -sourcepath . edu/internet2/middleware/grouper/app/loader/GrouperLoaderType.java

 mkdir /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/classes/edu/internet2
 mkdir /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/classes/edu/internet2/middleware
 mkdir /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/classes/edu/internet2/middleware/grouper
 mkdir /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/classes/edu/internet2/middleware/grouper/app
 mkdir /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/classes/edu/internet2/middleware/grouper/app/loader
 cp edu/internet2/middleware/grouper/app/loader/GrouperLoaderType* /opt/appserv/tomcat_3c/webapps/fastGrouperProdDaemon/WEB-INF/classes/edu/internet2/middleware/grouper/app/loader

General tips

Eclipse setup

Project setup

Checkstyle plugin

IntelliJ IDEA setup

Project setup

Checkstyle plugin

Coding defaults

Miscellaneous

Patch java example

See also