Gnowsis rocks so hard that the neighbours complain<\/b>. read on to know why:<\/p>\n
(also available at this wiki page<\/a>)<\/p>\n \nYes, we have AJAX, and we love it. You can call many services of gnowsis using XML\/RPC. The nice thing about this approach is, that every object that is defined as API of gnowsis inside a service.xml<\/tt> file is automatically hosted as XML\/RPC server. A small example to show what you can do when calling the TaggingApi<\/a>:\n<\/p>\n \nFirst the dependencies<\/strong>: to make this run, include the gnowsis.js dependencies. If you run gnowsis, go to <\/span>http:\/\/127.0.0.1:9993\/gnowsis-server\/PimoTaggingAPI.html<\/a> for an example.\n<\/p>\n \nWhen you have done that, the gnowsis_callXmlMethod() function is available. You can test that by calling something simple as this:\n<\/p>\n \nWe called a method to get tags with a certain name in it. The gnowsis_callXmlMethod()<\/tt> method takes three (or more) parameters. The result value is an XML\/RPC result. If you want to know what is possible in XML\/RPC see at the bottom for the external links. The result value is, in this case, an array containing named arrays (maps).\n<\/p>\n \nNote that when the server throws an exception, the exception message will be passed to the xml\/rpc client, so you know whats happening when it fails.\n<\/p>\n \nDownload gnowsis and run this page:\n<\/p>\n \nusing only these lines of code:<\/p>\n \nyes, you want to dig this?\n<\/p>\n \nYou can call all services that are listed in the corresponding service.xml<\/tt> files. Now comes the tricky part: You want to write an XPI plugin for Mozilla Firefox or Mozilla Thunderbird and access the nice sesame repository of gnowsis. That is possible, but it needs an adapted version of the jsolait library and it is easier to copy\/paste our working prototype than to hack something from scratch.\n<\/p>\n \nSo, all Mozilla fanatics that want to SPARQL from out there, please look at the code of this SVN project:\n<\/p>\n \nAll you have to do is copy\/paste the whole project, change some parameters, run the build.xml and you have a plugin for Thunderbird 1.5.\n<\/p>\n \nSo the first thing you have to do, is run through the usual GnowsisDevelopingBeta<\/a>. Then, you have a running gnowsis server with all the XML\/RPC services available on localhost:9993<\/tt>. <\/p>\n \nThe best way to use gnowsis XML\/RPC and AJAX services is, at the moment, to edit the HTML files in \/services\/gnowsis-server\/*.html. They form a nice basis to get started, we frequently enlarge them with more examples. You can also start any other HTML project on your harddisk, Javascript and JSOLAIT are rock-hard technology and run pretty easy.\n<\/p>\n \nNo real ajax library used yet<\/strong>. Did you notice? we did not use coldfusion or any other cool Ajax library. We will, surely, soon do that.\n<\/p>\n \nBe aware that our server only answers to requests coming from 127.0.0.1<\/tt>. So, you will not be able to run server-to-server programs with it. That is good that way: gnowsis is a desktop server, not a web server. If you feel to change that, you may want to look at that jetty.xml<\/tt> file closer, but be warned: opening gnowsis to the network is not just a small security risk, its really a problem. Don’t open the gnowsis ports to outside, people can easily run shell commands via the XML\/RPC port with your user’s rights and cause havoc on your machine.<\/p>\n \nApache XML\/RPC doc\n<\/p>\n \nDynamic HTML and XML: The XMLHttpRequest Object\n<\/p>\n Gnowsis rocks so hard that the neighbours complain. read on to know why: (also available at this wiki page) XML-RPC developing with gnowsis Yes, we have AJAX, and we love it. You can call many services of gnowsis using XML\/RPC. The nice thing about this approach is, that every object that is defined as API … <\/p>\nXML-RPC developing with gnowsis<\/h1>\n
\/\/ Example: call method getPossibleTagsForTagName of API 'tagging' on service 'gnowsis-server'\n\/\/ (include gnowsis.js and jsolait dependencies)\n\n\/\/ call method\nvar tags = gnowsis_callXmlMethod(\"gnowsis-server\", \"tagging\", \"getPossibleTagsForTagName\", rlabel);\n\/\/ result is an array of maps\nfor (var i = 0; i < tags .length; i++)\n{\n \/\/ tag is a map, an array with named index.\n var tag = tags[i];\n \/\/ read uri and name of result\n var tagUri = tag[\"uri\"];\n var tagName = tag[\"name\"];\n alert(\"hey, I found \"+tagName+\" (\"+tagUri+\")\");\n}\n\n<\/pre>\n<\/div>\nWhat happens in this script?<\/h2>\n
\/\/ (include dependencies)\n<head>\n<script type='text\/javascript' src='web\/jsolait\/init.js'><\/script>\n<script type='text\/javascript' src='web\/jsolait\/lib\/urllib.js'><\/script>\n\n<script type='text\/javascript' src='web\/jsolait\/lib\/xml.js'><\/script>\n<script type='text\/javascript' src='web\/jsolait\/lib\/xmlrpc.js'><\/script>\n<script type='text\/javascript' src='gnowsis.js'><\/script>\n<\/head>\n<\/pre>\n
\/\/ show the uri of the current user.\nalert(gnowsis_callXmlMethod('gnowsis-server','configure','getUserUri'));\n<\/pre>\nvar tags = gnowsis_callXmlMethod(\"gnowsis-server\", \"tagging\", \"getPossibleTagsForTagName\", rlabel);\n<\/pre>\n
The real rocking cool example<\/h1>\n
\n
\n
function runSerqlExample()\n{\n \/\/ turn debug alerts off\n gnowsis_showdebugalert = false;\n var formC = document.forms[\"formserqlexample\"];\n var queryString = formC.elements[\"rquery\"].value; \n try {\n\t var res = gnowsis_callXmlMethod(\"gnowsis-server\", \"dataaccess\", \"querySelect\", \n \t queryString, \"serql\");\n } catch (e)\n {\n alert(\"error querying: \"+e);\n }\n renderSerqlExample(res);\n}\n\n\/**\n * render the serql query result.\n * query result is a vector of hashmaps, pretty easy.\n *\/\nfunction renderSerqlExample(res)\n{\n gnowsis_debug(\"rendering table\");\n var render = \"<table>\";\n for (var i = 0; i < res.length; i++)\n {\n var row = res[i];\n \n \/\/ render header?\n if (i==0)\n {\n \trender+=\"<tr>\";\n\t\tfor (col in row)\n\t\t{\n render += \"<td>\"+col+\"<\/td>\"; \n }\n render += \"<\/tr>\";\n }\n \n \/\/ render row\n render+=\"<tr>\";\n for (col in row)\n {\n render += \"<td>\"+row[col]+\"<\/td>\"; \n }\n render += \"<\/tr>\";\n }\n render += \"<\/table>\";\n var exampleOut = document.getElementById('SerqlExampleoutput');\n gnowsis_debug(render);\n exampleOut.innerHTML = render;\n gnowsis_debug(\"finished\");\n}\n\n<\/pre>\n\n
So what services can I call?<\/h1>\n
\nWe encourage you to look at this service first:\n<\/p>\n\n
\n
And what about Mozilla and XUL?<\/h1>\n
\n
Ok, I want to do AJAX with gnowsis, what to do?<\/h1>\n
Restrictions and caveats<\/h1>\n
Links<\/h1>\n
\n
\n