Changes between Version 4 and Version 5 of UnderstandingGnowsis

07/27/06 13:04:17 (16 years ago)



  • UnderstandingGnowsis

    v4 v5  
    1 == Understanding Gnowsis == 
     1= Understanding Gnowsis = 
     3On this page you will find useful links to many documents and a tutorial that points to more pages with practical examples. 
    35 * GnowsisProjectStructure - what packages are where, whats all this code about? 
    46 * GnowsisComponents - what components does gnowsis consist of? 
    57 * UseCases - what are the handled use cases? 
    6  * [ publications] (more to come) 
     8 * GnowsisDevelopingBeta - how to develop gnowsis 
     9 * GnowsisProjectPlan - look here to see what we are doing at the moment and what will be done next. 
    710 * [ about] - some facts about the project 
    811 * [ credits] - credits 
    10 == Documents to read first == 
     13== Documents that help == 
    1114 * [ The PIMO report draft] - about our data structures 
    1215 * [ Sauermann2005a.pdf] from beginning to chapter 2.1, also chapter 2.6 
    13  * [ Sauermann2005d.pdf] chapter 3 is very good, Figure 5 gives a good overview and says much. 
     16 * [ Sauermann2005d.pdf] chapter 3 is very good, Figure 5 gives a good overview and says  
     18 * [ publications about gnowsis] (more to come) 
     19 * [ use cases] - three simple use cases what you can do with gnowsis 
    15  * [ use cases] - three simple use cases what you can do with gnowsis 
     21= The Gnowsis Developer Tutorial = 
     22This tutorial is targeted at developers that want to learn more about gnowsis and want to build applications based on gnowsis. The tutorial will give links to the gnowsis wiki and the Javadoc, pointing to more information about features. '''This tutorial contains only pointers, you should follow some links to learn more'''. 
     24== The gnowsis databases == 
     25Gnowsis provides four different RDF databases, for different uses: 
     26 * PimoStorage - The PimoStorage stores the user's '''Personal Information Model'''. Basically, that includes all ontologies, tags and wiki pages, and the relations to resources.  
     27 * ResourceStorage - Stores information about all resources that are extracted from the file-system, address-books, e-mails, websites. Its filled by Aperture and the ApertureSynchroniser. Sometimes applications add a resource here before they are tagged using the TaggingApi, so also the TaggingApi will store here. 
     28 * ConfigurationStorage - Configuration data such as user-name, e-mail address, namespaces and URI of the PIMO, etc. 
     29 * ServiceDataStorage - The service data storage provides a RDF database that can be used by any service of gnowsis to store arbitrary RDF data. Usually, this would be data like usage statistics, crawling reports, access restrictions, Icon configurations, user interface configurations, etc. 
     31'''As developer, the interesting bits for you are most of the time in the PimoStorage.''' What data to store there and how to store it is described in the [ PIMO report] 
     33== Accessing the RDF databases == 
     34To read and write data to these databases, you have four different possibilities: 
     36'''via the PimoService'''. 
     37This is the recommended way to read and write data. As you will mostly work on the PimoStorage and this storage makes use of named graphs, you can easily wreck things. Also you can quickly make the storage invalid, when you add or delete the wrong triples. The methods of the PimoService are tested and allow most manipulations you need in daily programmer's life. 
     39'''via the DataAccessService and XML/RPX''' 
     42'''via java calls from within the gnowsis VM.''' You call methods like these: 
    1747== WE need this document :-| ==