Additions:
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk-0.1-20070915/index.html 20070915 snapshot release]].
Deletions:
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk-0.1-20070915/index.html 20070915 snapshot release]].
Additions:
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk-0.1-20070915/index.html 20070915 snapshot release]].
Deletions:
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk-0.1-20061007/index.html 20061007 snapshot release]].
Additions:
The Subversion repository contains two branches: [[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/trunk/ trunk]] and [[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/branches/experimental/ experimental]]. The trunk contains utilities actually used by Starmapper, while the experimental branch contains additional classes and packages that I created for other purposes and may be useful. I recommend to check out the **[[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/branches/experimental/src/jezuch/utils/observable/ jezuch.utils.observable]]** package - I hope you don't faint at the sight of the sources :)
Deletions:
The Subversion repository contains two branches: [[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/trunk/ trunk]] and [[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/branches/experimental/ experimental]]. The trunk contains utilities actually used by Starmapper, while the experimental branch contains additional classes and packages that I created for other purposes and may be useful. I recommend to check out the **[[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/branches/experimental/src/jezuch/utils/observable/ jezuch.utils.obervable]]** package - I hope you don't faint at the sight of the sources :)
Additions:
- **jezuch.utils**: a collection of perverted things like [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/CollectionAdapter.html CollectionAdapter]] or [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/LookupSet.html LookupSet]]. Basically just a junkyard of ideas of how to avoid loops and write everything the most declarative and/or functional way.
- **jezuch.utils.parameters**: an attempt to make [[http://java.sun.com/j2se/1.5.0/docs/api/java/util/Properties.html java.util.Properties]] more type-safe. When I think of it, it reminds me of jelly (no, not the brain-damaged attempt to turn XML into programming language). Basically the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/parameters/Parameters.html Parameters]] class maps keys (of generic type K) to... something. This "something" is given as an argument to calls to [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/parameters/Parameters.html#setValue(java.lang.Class,%20K,%20T) setValue]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/parameters/Parameters.html#getValue(java.lang.Class,%20K,%20T) getValue]] - you can put something as a String and get out as an Integer - and it will convert it on-the-fly for you (if the String does not represent a valid Integer, it will throw an exception). You can install validators for keys that will guard for proper values (they have a side-effect of being type-keepers for values). You can request a live view of the values as a [[http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html Map]] to values of any specified type (again, conversion will be done on-the-fly). Just pure sweetness.
- **jezuch.utils.io**: currently contains only a [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/io/ReaderSource.html ReaderSource]] interface and its two implementations (for files and URLs). It's nothing more than a factory for [[http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html Reader]]s.
- **jezuch.utils.ini**: a simple parser for INI files; Starmapper has historically used this format for configuration files. It's simple and popular (thanks to Microsoft, mostly), so why not? It parses the file and exposes it as a [[http://java.sun.com/j2se/1.5.0/docs/api/java/util/Set.html Set]]<[[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/jezuch/utils/ini/INISection.html INISection]]> [**SIDENOTE**: in Starmapper version 3 this simplicity gets a bit in the way of new [[UnifiedConfigurationModel unified configuration model]] employed by the two default applications, but it's a minor annoyance only].
Deletions:
- **jezuch.utils**: a collection of perverted things like [[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/CollectionAdapter.html CollectionAdapter]] or [[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/LookupSet.html LookupSet]]. Basically just a junkyard of ideas of how to avoid loops and write everything the most declarative and/or functional way.
- **jezuch.utils.parameters**: an attempt to make [[http://java.sun.com/j2se/1.5.0/docs/api/java/util/Properties.html java.util.Properties]] more type-safe. When I think of it, it reminds me of jelly (no, not the brain-damaged attempt to turn XML into programming language). Basically the [[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/parameters/Parameters.html Parameters]] class maps keys (of generic type K) to... something. This "something" is given as an argument to calls to [[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/parameters/Parameters.html#setValue(java.lang.Class,%20K,%20T) setValue]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/parameters/Parameters.html#getValue(java.lang.Class,%20K,%20T) getValue]] - you can put something as a String and get out as an Integer - and it will convert it on-the-fly for you (if the String does not represent a valid Integer, it will throw an exception). You can install validators for keys that will guard for proper values (they have a side-effect of being type-keepers for values). You can request a live view of the values as a [[http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html Map]] to values of any specified type (again, conversion will be done on-the-fly). Just pure sweetness.
- **jezuch.utils.io**: currently contains only a [[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/io/ReaderSource.html ReaderSource]] interface and its two implementations (for files and URLs). It's nothing more than a factory for [[http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html Reader]]s.
- **jezuch.utils.ini**: a simple parser for INI files; Starmapper has historically used this format for configuration files. It's simple and popular (thanks to Microsoft, mostly), so why not? It parses the file and exposes it as a [[http://java.sun.com/j2se/1.5.0/docs/api/java/util/Set.html Set]]<[[http://starmapper.sourceforge.net/api/jezuch-utils/jezuch/utils/ini/INISection.html INISection]]> [**SIDENOTE**: in Starmapper version 3 this simplicity gets a bit in the way of new [[UnifiedConfigurationModel unified configuration model]] employed by the two default applications, but it's a minor annoyance only].
Additions:
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk-0.1-20061007/index.html 20061007 snapshot release]].
Deletions:
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/0.1-20061007/index.html 20061007 snapshot release]].
Revision [76]
Edited on
2007-08-08 11:21:17 by KrzysztofSobolewski
[Update about branches, SVN and javadocs locations.]
Additions:
The Subversion repository contains two branches: [[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/trunk/ trunk]] and [[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/branches/experimental/ experimental]]. The trunk contains utilities actually used by Starmapper, while the experimental branch contains additional classes and packages that I created for other purposes and may be useful. I recommend to check out the **[[http://starmapper.svn.sourceforge.net/viewvc/starmapper/jezuch-utils/branches/experimental/src/jezuch/utils/observable/ jezuch.utils.obervable]]** package - I hope you don't faint at the sight of the sources :)
So, if you're interested, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/index.html javadocs for trunk]] and [[http://starmapper.sourceforge.net/api/jezuch-utils/experimental/index.html experimental]]. There are also javadocs for [[http://starmapper.sourceforge.net/api/jezuch-utils/trunk/0.1-20061007/index.html 20061007 snapshot release]].
Deletions:
There are at least two more packages with some crazy ideas, but the aren't used in Starmapper (or anywhere else) so I don't feel like exposing them right now (I don't even know if they're **good** ideas).
So, if you want to dive in, check out the [[http://starmapper.sourceforge.net/api/jezuch-utils/index.html javadocs]].