Skip to content
A set of examples for ModeShape, which is a lightweight, fast, pluggable, open-source, federating JCR implementation that can unify content from multiple systems, including files systems, databases, data grids, other repositories, etc.
Java HTML
Failed to load latest commit information.
modeshape-cmis-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-custom-logging-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-custom-security-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-ddl-parser-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-embedded-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-federation-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-jca-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-jdbc-store-example
modeshape-jdk-logging-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-log4j-logging-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-logback-logging-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-rest-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-sequencing-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-slf4j-logging-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-spring-atomikos-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-spring-security-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-tomcat-jdbc-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-tomcat-jsf-example Changed to use release 5.1.0.Final. Jun 15, 2016
modeshape-webdav-example Changed to use release 5.1.0.Final. Jun 15, 2016
.gitignore MODE-2356 Added embeddable WebDAV example. Nov 7, 2014
.travis.yml Adds caching to the Travis script Jun 17, 2016
LICENSE.txt Updated copyright to ASL2. Jun 5, 2014
README.md MODE-2599 Added Travis-CI build Jun 14, 2016
pom.xml MODE-2543 Updates the examples to ModeShape 5. Mar 3, 2016
settings.xml Added settings.xml to make building easier. Jan 30, 2013

README.md

License Maven Central Build Status

The ModeShape project

ModeShape is an open source implementation of the JCR 2.0 (JSR-283) (aka, 'JCR') specification and standard API. To your applications, ModeShape looks and behaves like a regular JCR repository. Applications can search, query, navigate, change, version, listen for changes, etc. But ModeShape can store that content in a variety of back-end stores or it can access and update existing content from other kinds of systems (including file systems, SVN repositories, JDBC database metadata, and other JCR repositories). ModeShape's connector architecture means that you can write custom connectors to access any kind of system. And ModeShape can even federate multiple back-end systems into a single, unified virtual repository.

For more information on ModeShape, including getting started guides, reference guides, and downloadable binaries, visit the project's website at http://www.modeshape.org or follow us on our blog or on Twitter. Or hop into our IRC chat room and talk our community of contributors and users.

The official Git repository for the project is also on GitHub at http://github.com/ModeShape/modeshape.

Examples

This Git repository contains examples showing how to use ModeShape within your applications. Each example is a self-contained Maven project that is ready to use.

To run the examples, simply clone the repository:

$ git clone git://github.com/ModeShape/modeshape-examples.git
$ cd modeshape-examples

Then use Maven to build all of the examples (and run any unit tests):

$ mvn clean install -s settings.xml

or you can build an individual example. For instance:

$ cd modeshape-embedded-example
$ mvn clean install -s settings.xml

See this ModeShape community article for help on how to install Maven 3.

Looking for ModeShape 4.x or 3.x examples?

The code on the 'master' branch works against the latest ModeShape 5.x release, but examples for ModeShape 4.x and 3.x are on different branches. To get to those, use the Git checkout command to switch branches:

$ git checkout 4.x

or

$ git checkout 3.x

and then use the Maven command to build the examples (same as above).

Need help?

ModeShape is open source software with a dedicated community. If you have any questions or problems, post a question in our user forum or hop into our IRC chat room and talk our community of contributors and users.

Contribute an example

We're always looking for good, easy to follow examples. If you've written one and would like to help, simply use GitHub's Fork and Pull-Request techniques.

  1. Use the "Fork" button at the top of this page on GitHub to create your own fork.
  2. Clone your fork:
    $ git clone git@github.com:<you>/modeshape-examples.git
    $ cd modeshape-examples
    $ git remote add upstream git://github.com/ModeShape/modeshape-examples.git
    
  3. Create a topic branch
    $ git checkout -b <branch-name>
    
  4. Make your changes
  5. When all of the examples (including yours) build, commit to that branch
    $ git commit .
    
  6. Push your commit(s) to your fork on GitHub
    $ git push origin <branch-name>
    
  7. On GitHub.com, go to your fork and switch branches to your topic branch, press the 'Pull Request' button, and fill out the form with the details.

We'll then review your submission and, if it works and builds, merge it into the examples repository.

Something went wrong with that request. Please try again.