search

eclipse-sisu / sisu-project

Sisu Inject
https://www.eclipse.org/sisu
Eclipse Public License 2.0
17 stars 15 forks source link

readme 

+-----------+---+-----------+---+---+
|           |   |           |   |   |
|   O-------+   |   O-------+   |   |
|           |   |           |   |   |
+-------O   |   +-------O   |   O   |
|           |   |           |       |
+-----------+---+-----------+-------+

build maintainability license

Sisu is a modular JSR330-based container that supports classpath scanning, auto-binding, and dynamic auto-wiring.

Sisu uses Google-Guice to perform dependency injection and provide the core JSR330 support, but removes the need to write explicit bindings in Guice modules. Integration with other containers via the Eclipse Extension Registry and the OSGi Service Registry is a goal of this project.

Maven

<dependency>
  <groupId>org.eclipse.sisu</groupId>
  <artifactId>org.eclipse.sisu.inject</artifactId>
  <version>0.3.5</version>
</dependency>

Documentation

Sisu in 5 minutes

Javadoc

Generation of Named Index

Often Sisu's SpaceModule doesn't scan the full classpath at run time (for relevant annotations) but relies on a pre-generated index at META-INF/sisu/javax.inject.Named. There are two different ways how to create such an index file:

  1. By leveraging the Java annotation processor in org.eclipse.sisu.space.SisuIndexAPT6 to generate the index. One needs to enable via javac -processor org.eclipse.sisu.space.SisuIndexAPT6 or with the according maven-compiler-plugin parameter annotationProcessors.
  2. By leveraging the dedicated Maven plugin https://github.com/eclipse/sisu.mojos/

Related projects

https://github.com/eclipse/sisu.mojos/

https://github.com/eclipse/sisu.plexus/

How to Contribute

We accept contributions via GitHub pull requests. Please see How To Contribute to get started.

License

Meaning of sisu

From https://en.wikipedia.org/w/index.php?title=Sisu&oldid=371994592

Sisu is a Finnish term loosely translated into English as strength of will, determination, perseverance, and acting rationally in the face of adversity. However, the word is widely considered to lack a proper translation into any language. Sisu has been described as being integral to understanding Finnish culture. The literal meaning is equivalent in English to "having guts", and the word derives from sisus, which means something inner or interior. However sisu is defined by a long-term element in it; it is not momentary courage, but the ability to sustain an action against the odds. Deciding on a course of action and the sticking to that decision against repeated failures is sisu. It is similar to equanimity, except the forbearance of sisu has a grimmer quality of stress management than the latter. The noun sisu is related to the adjective sisukas, one having the quality of sisu.

Additional information