This contains information related to the Entity Broker system (a.k.a. entity 2.0) in Sakai. Ideally we want flexible entities which make development of integrated Sakai tools easier and more flexible. Our goals are to make the entity system easier on developers (easier to use and understand) and more powerful (easier to extend and improve).
In the EB system the concept of an entity is very flexible. It can be a POJO, persistent object, string, or really anything you like. Entities do not have to be backed by database data or even real data at all. Each entity type (as defined by a unique prefix) has a set of capabilities associated with it. These are fine-grained and defined by the developer who writes the EntityProvider for that entity type. An EntityProvider can reside in a Sakai component or a webapp and can implement as few as one interface with one method or as many methods as the developer desires.
The Entity Broker seamlessly integrates with the existing Entity system in Sakai (EntityProducer and Entity) and entities created using entity providers are accessible in Sakai as if they were created using the legacy system.
In the Entity Broker system we refer to entities using globally unique but well-known references constructed from ids and prefixes.
prefix = globally unique identifier for an entity type (e.g. blog-entry, eval-template)
id = locally unique identifier for an entity of a type (e.g. 1, "one")
reference = globally unique identifier (or reference) to an entity (e.g. /prefix/id, /eval-item/5)
space = a way to refer to an entity type (e.g. blog-entry, eval-template) (e.g. /prefix)
- Support technology, tool, and entity interoperability using conventions and references without hard dependencies
- Make it easier for developers to work with and integrate their tools with Sakai
- Provide for easier support for RESTful URLs and clean URL spaces
- Entity Provider and Broker Usage
Usage with presentation frameworks (for URLs)
- Capabilities are extensions to the the entity provider and broker system. They allow the entity system to be easily extended in a way which does not create interlocking dependencies and even allows multiple projects to implement capabilities for the same entity set.
Capabilites can be created by anyone and should be located within the relevant project, though there are some capabilities that are within the entity broker project.
- In core Sakai release
- Add support for custom actions (via REST)
- Add support for URL redirects
- Move to kernel
- Add support for archiving entities
- Add support for searching entities
- Entity Broker trunk code (in Sakai trunk): https://source.sakaiproject.org/svn/entitybroker/trunk/
- Version 1.3.6 release (recommended): https://source.sakaiproject.org/svn/entitybroker/tags/entitybroker-1.3.6/
- Version 1.3.3 release (included in Sakai 2.5.3): https://source.sakaiproject.org/svn/entitybroker/tags/1.3.3/
- Version 1.2.0 release (included in Sakai 2.5.0): https://source.sakaiproject.org/svn/entitybroker/tags/1.2/
- Installation is the same as for other sakai add-ons and tools
- Check for older versions of the entitybroker jars in your TOMCAT_HOME/shared/lib and remove any you find
mvn clean install sakai:deployfrom inside the entitybroker svn checkout root
- Take a look here if you are interested in the concepts behind entities or the way things link together