API for java-utils
Full namespace name: clojure.contrib.java-utils
A set of utilties for dealing with Java stuff like files and properties.
(1) Ease-of-use. These APIs should be convenient. Performance is secondary.
(2) Duck typing. I hate having to think about the difference between
a string that names a file, and a File. Ditto for a ton of other
wrapper classes in the Java world (URL, InternetAddress). With these
APIs you should be able to think about domain equivalence, not type
(3) No bossiness. I am not marking any of these functions as private
the docstrings will tell you the intended usage but do what works for you.
If something in this module violates the principle of least surprise, please
let me (Stu) and the Clojure community know via the mailing list.
Stephen C. Gilardi
Public Variables and Functions
Usage: (as-properties m)
Convert any seq of pairs to a java.utils.Properties instance.
Uses name to convert both keys and values into strings.
Usage: (get-system-property stringable)
(get-system-property stringable default)
Get a system property.
Usage: (read-properties file-able)
Read properties from file-able.
Usage: (set-system-properties settings)
Set some system properties. Nil clears a property.
Usage: (with-system-properties settings & body)
setting => property-name value
Sets the system properties to the supplied values, executes the body, and
sets the properties back to their original values. Values of nil are
translated to a clearing of the property.
Usage: (write-properties m file-able)
(write-properties m file-able comments)
Write properties to file-able.