Developer Use
Using an Icon in your tool
A tool deloper who wants to use the delete icon would use
<img src="/iconservice/get/icon/delete">
what will be displayed how ever is really the icon configured for that icon id in the theme that gets used for the request, but that fact will be completely transparent to the developer and end users.
Clearing the cache
One of the main requests of tool UI developers using a service such as this is to be able to do 'live editing', because the icon service caches in memory every thing it touches to do this the cache will need to be cleared after making changes. Clearing the cache is easy, simply point your web browser to:
${YOUR_SAKAI_URL}/iconservice/get/clear
and your changes will be available.
Getting an avaibale icon list
To get a listing of all the themes in your sakai go to:
${YOUR_SAKAI_URL}/iconservice/get/list
From there you can click on a theme to get a listing of all the icons in that theme as well as the urls to use for each.
(Should this just be a table where each theme gets a column? Let me know if you think so.)