Information

Describes the usage of entity URLs in RSF and how to define where your entity URLs go in your tools and webapps. This will allow you to tie into the direct url system which gives the developer control of their URL space and opens up access to what we call entity worlds.

Implementing Entity URLs in RSF

  1. Implement the EntityViewParamsInferrer (in Sakai RSF)
    1. Note: You are defining the View (page) and ViewParameters (get params) which an entity resolves to, this gives the developer full control of direct URLs to their tool space without code crossing over into the service/component layer
  2. Add implementation as a spring bean to your RSF applicationContext.xml in your tool
    Example:
    <bean class="org.sakaiproject.sample.tool.inferrers.SampleVPInferrer">
    </bean>
    
  3. Add in the extra spring config files to your tool web.xml if they are not already there:
    1. contextConfigLocation should have:
      classpath:conf/sakai-entitybroker-applicationContext.xml
      
    2. requestContextConfigLocation should have:
      classpath:conf/sakai-entitybroker-requestContext.xml
      
  4. Add the needed maven dependendencies to the tool maven files

Usage of Entity URLs

There are methods in EntityBroker which will help you to generate URLs directly to entities. The URLs are like this: http://server:port/direct/prefix/id

More info at Entity URLs defined