This tutorial introduces the concept of "external projections". You may specify a document origin per projection method. This way a projection may project data of multiple documents into one Java object. As example we take the XML interfaces of a Dreambox. A Dreambox is a hard disk video recorder with a web based interface that works with XML data exchange from multiple URLs. This example is provided to show a real life use case for integration of multiple external documents to one Java interface. You are surly not able to run this example without access to specific version of this hard disk recorder. Therefore there is no example code provided which uses this interface.
public interface Dreambox { // This is the root XBDocURL of my device. @XBDocURL(BASE_URL + "/movielist?dirname={0}") @XBRead("/e2movielist/e2movie") List<Movie> getMovies(String location); @XBDocURL(BASE_URL + "/getservices?sRef=1%3A7%3A1%3A0%3A0%3A0%3A0%3A0%3A0%3A0%3AFROM%20BOUQUET%20%22userbouquet.favourites.tv%22%20ORDER%20BY%20bouquet") @XBRead("/e2servicelist/e2service") List<Service> getServices(); @XBDocURL(BASE_URL + "/web/epgservice?sRef={0}") @XBRead("/e2eventlist/e2event") List<Event> getEvents(String serviceReference); @XBDocURL(BASE_URL + "/web/getlocations") @XBRead("e2locations/e2location") List<String> getLocations();} |